Avant de commencer
- Le devis de la Box est validé et vos accès sont appliqués. Dans « Machines instanciées », la section « Identité pour le déploiement physique » n’est plus verrouillée.
- Vous êtes responsable habilité du site ou super-administrateur : le jeton et le kit vous sont réservés.
- La Box est un ordinateur sous Ubuntu, processeur x86_64 (amd64) ou ARM 64 bits (arm64), et vous disposez d’un accès administrateur (root).
- Le pare-feu du site laisse sortir la Box vers le Cloud Lesly sur le port 8443. Il laisse aussi sortir vers *.azurecr.io et le stockage du registre, *.blob.core.windows.net, sur le port 443. Pendant l’installation, il laisse aussi sortir vers download.docker.com, github.com et release-assets.githubusercontent.com sur le port 443. Il laisse enfin joindre le dépôt de paquets Ubuntu sur le port 80 : archive.ubuntu.com et security.ubuntu.com, ports.ubuntu.com en arm64, ou le miroir interne du site.
- Utilisez toujours le kit de la release courante, retéléchargé par « Télécharger le kit ». Un kit plus ancien réinstalle un agent plus ancien, et sa vérification échoue.
Étapes
Préparer l’identité, le jeton et le kit dans le Cloud
Ouvrez « Machines instanciées », choisissez le site puis la Box. Dans « Identité pour le déploiement physique », cliquez « Générer l'ID de la Box » : l’identifiant lbx_… s’affiche. Cliquez « Générer le jeton », puis « Télécharger le kit ». Le navigateur vérifie l’empreinte SHA-256 du kit avant de l’enregistrer. Le jeton s’affiche une seule fois, sert une seule fois et expire rapidement.
Copier le kit sur la Box
Copiez le fichier « leslyInstallationKit-<version>.run » sur la Box, dans un dossier de travail. Ouvrez un terminal administrateur avec « sudo -i » et placez-vous dans ce dossier. Rendez le kit exécutable : « chmod +x leslyInstallationKit-<version>.run ». Si le site utilise un VPN, posez aussi son profil .ovpn dans ce dossier : le kit le prend en charge. Le guide sur le VPN et les options de la Box détaille ce cas.
Lancer l’installation
Dans « Machines instanciées », ouvrez « Commande kit terrain » et copiez ses lignes dans le terminal administrateur de la Box. Remplacez <version> par la version du kit téléchargé. Ces lignes ne s’affichent qu’après « Générer le jeton », et disparaissent au rechargement de la page. Le premier argument du kit est toujours « --role edge », suivi de « --install » et de « --box-id lbx_… ». Le kit installe Docker et ses outils, enrôle la Box avec le jeton, puis attend la première mise à jour, jusqu’à 12 minutes environ. Ne transmettez jamais le jeton par message ni dans un ticket. Après l’installation, supprimez du dossier de travail le fichier .ovpn et « auth.txt » : la Box garde sa propre copie protégée.
Réinstaller une Box déjà installée
Une réinstallation n’a besoin ni de jeton ni de « --box-id » : la Box garde son identité. Elle a besoin de l’adresse du Cloud. Ouvrez un terminal administrateur avec « sudo -i » et placez-vous dans le dossier du kit. Chargez l’adresse enregistrée : « export $(grep ^CONTROL_PLANE_URL= /etc/lesly/agent.env) ». Contrôlez-la : « echo $CONTROL_PLANE_URL » doit afficher une adresse en https. Si vous avez retéléchargé le kit, rendez-le exécutable comme à l’étape de copie. Dans ce même terminal, lancez « ./leslyInstallationKit-<version>.run --role edge --install », sans « sudo » devant. Sont conservés : l’identifiant et le certificat de la Box, ses données d’exécution, les données de ses machines, ses options, son profil VPN et les mots de passe des outils d’administration. Le logiciel et les releases téléchargées sont réinstallés. La collecte s’arrête jusqu’à la fin de la réinstallation et de la mise à jour suivante. « --role edge --uninstall » retire seulement le logiciel. Avec « --purge » en plus, l’identité est détruite et un nouvel enrôlement devient nécessaire.
Vérifier l’installation
Le kit doit se terminer sans erreur. Pour vérifier plus tard, retéléchargez le kit de la release courante, puis lancez-le avec « --role edge --verify ». Il conclut par « Box opérationnelle » puis « edge verify OK ». Dans « Machines instanciées », la Box affiche « Box enregistrée » et son dernier contact. Les mises à jour suivantes arrivent ensuite seules, à chaque release, sans relancer le kit.
Résultat attendu
Le kit se termine sans erreur, « --role edge --verify » confirme une Box opérationnelle, et le Cloud affiche la Box enregistrée avec un contact récent. La Box se met ensuite à jour seule.
Si cela ne fonctionne pas
Message « argument inconnu » : le premier argument du kit n’est pas « --role edge » ; reprenez la commande fournie. Message du kit contenant « requises absentes » : les lignes de « Commande kit terrain » ont été collées dans un autre terminal, ou le kit a été lancé par « sudo » sans « -E ». Recollez-les dans le terminal administrateur qui lance le kit. Pendant une réinstallation, ce message peut arriver après la désinstallation : « /etc/lesly/agent.env » n’existe alors plus. Demandez l’adresse du Cloud à l’intégrateur Lesly, chargez-la avec « export CONTROL_PLANE_URL=<URL> », puis relancez « --install » : l’identité est conservée. Box neuve refusée faute d’identifiant : ajoutez « --box-id » avec l’identifiant lbx_… affiché dans le Cloud. Message sur le jeton d’enrôlement absent, vide ou mal protégé : recréez-le avec les lignes de « Commande kit terrain », dans le terminal administrateur. « Commande kit terrain » a disparu : la page a été rechargée ou le jeton a expiré ; générez un nouveau jeton. Jeton refusé ou expiré : générez un nouveau jeton dans le Cloud (« Générer le jeton » ou « Régénérer »), puis relancez. Message du kit contenant « kit courant » : le kit et la Box ne sont pas sur la même release. Si le kit est ancien, retéléchargez-le ; si la Box n’a pas encore reçu la dernière release, attendez la mise à jour suivante. Relancez ensuite la vérification. Message « AUCUN contact control-plane » après environ 12 minutes : le port 8443 sortant est filtré, ou l’adresse du Cloud est fausse. Faites vérifier le pare-feu du site. Message « Box NON opérationnelle » : la Box est à jour, mais les accès des utilisateurs n’y sont pas encore appliqués. Vérifiez les accès du site, puis relancez « --role edge --verify ». Certificat de la Box expiré : un nouvel enrôlement est nécessaire ; contactez le super-administrateur. Processeur refusé : seuls amd64 et arm64 sont pris en charge. Transmettez à l’intégrateur Lesly le site, l’identifiant lbx_…, l’heure et les dernières lignes affichées par le kit.