6.8 KiB

Raw Blame History

Premiers pas

Prérequis

Pour le serveur, une machine Ubuntu 22.04
Pour l'agent, un RaspberryPi version 3

Étapes

Préparer votre RaspberryPi

Sur la page des "versions" des firmwares du projet Emissary, télécharger la dernière version disponibles correspondant à votre système cible, dans le cas présent openwrt-<openwrt_version>-emissary-<emissary_firmware_version>-bcm27xx-bcm2710-rpi-3-ext4-factory.img.gz

Brancher votre carte SD dans le lecteur, flasher celle ci avec le firmware:

# Chemin vers le fichier de firmware précédemment téléchargé
FIRMWARE_FILE="openwrt-<openwrt_version>-emissary-<emissary_firmware_version>-bcm27xx-bcm2710-rpi-3-ext4-factory.img.gz"

SDCARD_DEVICE=/dev/sdX  # Chemin vers le "device" correspondant à votre carte SD

# Décompresser le firmware
gzip -d "${FIRMWARE_FILE}"

# Flash la carte SD
sudo dd if="${FIRMWARE_FILE%.gz}" of="${SDCARD_DEVICE}" bs=2M conv=fsync

# Attendre la fin des écritures
sudo sync

Placer votre carte SD dans votre RaspberryPi, le connecter à votre réseau en Ethernet puis l'allumer.

Scanner votre réseau pour trouver l'adresse IP de votre Raspberry Pi. Par exemple, avec l'outil nmap:

sudo nmap -sP 192.168.0.*   # À modifier par le préfixe correspondant à votre réseau local

Une entrée équivalente à la suivante devrait être affichée:

Starting Nmap 7.93 ( https://nmap.org ) at 2023-05-25 19:29 CEST
Nmap scan report for 192.168.0.24
Host is up (0.0034s latency).
MAC Address: B8:27:EB:E5:7B:55 (Raspberry Pi Foundation)
[...]

Se connecter en SSH sur votre RaspberryPi et définir un mot de passe pour le compte administrateur:
```
ssh root@<ip>

passwd
```

Installer le serveur Emissary

Sur la machine Ubuntu 22.04, télécharger les paquets Emissary sur la page "Versions" du projet. Dans le cas présent, choisir le paquet Debian emissary-server_<emissary_version>_linux_<arch>.deb où <arch> correspond à l'architecture CPU de votre machine.

Installer le paquet télécharger via dpkg:

sudo dpkg -i emissary-server_<emissary_version>_linux_<arch>.deb

Appliquer les migrations sur la base de données:

sudo emissary --workdir /usr/share/emissary --config /etc/emissary/server.yml server database migrate

Redémarrer le service:
```
sudo systemctl restart emissary-server
```

Créer un jeton d'administration:

sudo emissary --workdir /usr/share/emissary --config /etc/emissary/server.yml server auth create-token --role writer --subject $(whoami)

Note Le jeton sera stocké dans le répertoire $HOME/.config/emissary.

Vérifier l'authentification sur l'API:

emissary api agent query

Une réponse équivalente à la suivante devrait s'afficher:

+----+-------+------------+--------+-------------+-----------+
| ID | LABEL | THUMBPRINT | STATUS | CONTACTEDAT | UPDATEDAT |
+----+-------+------------+--------+-------------+-----------+
+----+-------+------------+--------+-------------+-----------+

Appairer l'agent avec votre serveur

Sur le RaspberryPi, exécuter la commande suivante:

uci set emissary.agent.server_url='http://<server_ip>:3000'
uci commit emissary
reload_config

Via la commande logread, vérifier que l'agent arrive à se connecter avec le serveur:

logread -f

Un message de ce type devrait s'afficher:

Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.611 [INFO]	<./internal/agent/controller/persistence/controller.go:58>	(*Controller).Reconcile	no changes detected, doing nothing	{"controller": "persistence-controller"}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.675 [ERROR]	<./internal/agent/controller/spec/controller.go:43>(*Controller).reconcileAgent	unexpected agent status	{"controller": "spec-controller", "agentID": 1, "status": 0}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.676 [INFO]	<./internal/agent/controller/openwrt/uci_controller.go:32>	(*UCIController).Reconcile	could not find uci spec, doing nothing	{"controller": "uci-controller"}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.677 [INFO]	<./internal/agent/controller/app/controller.go:43>	(*Controller).Reconcile	could not find app spec	{"controller": "app-controller"}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.678 [INFO]	<./internal/agent/controller/proxy/controller.go:35>(*Controller).Reconcile	could not find proxy spec	{"controller": "proxy-controller"}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.680 [INFO]	<./internal/agent/controller/mdns/controller.go:38>(*Controller).Reconcile	could not find mdns spec	{"controller": "mdns-controller"}
Thu May 25 18:48:51 2023 daemon.info emissary[2202]: 2023-05-25 18:48:51.680 [INFO]	<./internal/agent/controller/openwrt/sysupgrade_controller.go:36>	(*SysUpgradeController).Reconcile	could not find sysupgrade spec, doing nothing	{"controller": "sysupgrade-controller"}

Sur le serveur, vérifier que l'agent a pu s'enregistrer:

emissary api agent query

Un message de ce type devrait s'afficher:

+----+-------+-----------------------------------+--------+-----------------------------------+-----------------------------------+
| ID | LABEL | THUMBPRINT                        | STATUS | CONTACTEDAT                       | UPDATEDAT                         |
+----+-------+-----------------------------------+--------+-----------------------------------+-----------------------------------+
| 1  |       | 21CnUATcboKCaheb2uczWCuoxTZtnp... | 0      | 2023-05-25 18:49:51.652680196 ... | "2023-05-25T18:49:51.589225817... |
+----+-------+-----------------------------------+--------+-----------------------------------+-----------------------------------+

Noter l'identifiant associé à l'agent.

Mettre à jour le statut de l'agent afin qu'il soit en capacité à récupérer ses spécifications:
```
emissary api agent update --agent-id <agent_id> --status 1
```

Bravo, vous avez appairé votre premier agent et son serveur Emissary !

6.8 KiB Raw Blame History