Un nœud que vous avez enrôlé n'est pas listé
Symptom
L’installeur s’est terminé sur la machine, et Nœuds dans le tableau de bord ne la liste pas — ou la liste mais elle ne devient jamais prête. GET /api/v1/nodes ne la retourne pas non plus, ce n’est donc pas un problème d’affichage.
Diagnose
-
Le moteur d’exécution de conteneurs fonctionne-t-il sur la machine ?
docker infoAttendez-vous à une section serveur avec une version.
Cannot connect to the Docker daemonsignifie que l’agent n’a rien à piloter, et il ne signalera pas qu’il est prêt. -
L’agent a-t-il démarré, et qu’a-t-il dit ?
sudo journalctl -u odysseus-agent --since "10 minutes ago"Attendez une ligne de démarrage suivie d’un enregistrement réussi. Les échecs d’authentification, les délais de connexion et les erreurs d’API d’exécution se nomment eux-mêmes ici.
-
Le jeton d’inscription a-t-il déjà été utilisé ? Les jetons sont à usage unique et expirent. Une seconde exécution de la même commande d’installation est refusée, et ce refus ressemble à un échec silencieux si personne ne lit le journal.
-
La machine peut-elle atteindre le plan de contrôle ? L’agent maintient une connexion sortante ; un nœud qui s’inscrit puis se tait est généralement un problème d’égress, pas d’inscription.

Resolve
- Runtime non démarré : démarrez-le, puis redémarrez l’agent. L’agent n’a pas besoin d’être réinscrit.
- Jeton consommé ou expiré : émettez-en un nouveau depuis Nœuds → Inscrire un nœud et exécutez la commande fraîche. Ne réexécutez pas l’ancienne ligne : elle porte le jeton consommé.
- Sortie bloquée : ouvrez le HTTPS sortant vers le plan de contrôle. Rien côté plateforme ne peut compenser une machine incapable d’appeler l’extérieur.
- Inscrit sous le mauvais locataire : un nœud appartient à un locataire et ne change pas. Supprimez-le et inscrissez-le à nouveau depuis le bon.
Prevent
Inscrivez-vous depuis le tableau de bord au moment où vous exécutez la commande, afin que le jeton soit frais, et vérifiez que le nœud atteint l’état prêt avant de fermer le shell. Une machine qui va échouer à l’inscription échoue en environ une minute, et la ligne de journal indiquant pourquoi n’est facile à trouver que lorsqu’elle est la dernière.