Inscrire un nœud

Goal

Une machine à vous enregistrée auprès du plan de contrôle et prête à recevoir des conteneurs.

Before you start

• Une machine Linux avec Docker installé et un shell root.
• Connexion HTTPS sortante de cette machine vers le plan de contrôle.
• Droits d’inscription dans votre locataire. Un nœud appartient à un seul locataire, comme le décrit multilocation et isolation.

Dashboard

Steps

1. Ouvrez Nœuds et choisissez Inscrire un nœud.
2. Copiez la commande d’installation. Elle contient un jeton d’inscription à usage unique.
3. Exécutez-la en tant que root sur la machine.
4. Surveillez l’apparition du nœud dans la liste et son passage à l’état prêt.

REST API

Steps

1. POST /api/v1/nodes/enroll pour obtenir un jeton d’enrôlement pour un nom de nœud de votre choix.
2. GET /api/v1/bootstrap/script sur la machine, avec ce jeton, pour récupérer le programme d’installation.
3. Exécuter le programme d’installation en tant que root. Il appelle POST /api/v1/bootstrap/validate puis POST /api/v1/bootstrap/complete.
4. GET /api/v1/nodes et confirmer que le nœud est listé.

CLI

Steps

1. Il n’existe pas de commande d’enrôlement en CLI. Le programme d’installation fourni par le tableau de bord et l’API est l’outil côté nœud, et c’est le même script dans les deux cas.
2. Utiliser le tableau de bord ou l’onglet API ci-dessus ; le rôle de la CLI ici est l’inspection, pas l’enrôlement.

Verify

Le nœud est listé et prêt, et GET /api/v1/nodes/{name} le retourne.

Evidence this worked

La dernière ligne du programme d’installation signale que l’agent est enrôlé, et le premier appel du nœud modifie son état dans la liste en environ trente secondes. Un nœud qui n’apparaît jamais n’a pas terminé l’enrôlement — le jeton a été consommé par une tentative précédente, ou la machine ne peut pas joindre le plan de contrôle.

When it fails

• Le jeton est refusé comme déjà utilisé. Les jetons d’enrôlement sont à usage unique. En émettre un autre plutôt que de relancer l’ancienne commande ; une copie obsolète de la ligne d’installation est la cause la plus fréquente.
• Le nœud apparaît et ne devient jamais prêt. L’agent est enrôlé mais ne peut pas maintenir sa connexion sortante. Vérifier l’acheminement sortant plutôt que l’enrôlement.
• Le nœud appartient à un autre locataire. Les nœuds ne passent pas d’un locataire à l’autre ; la machine doit être supprimée et enrôlée à nouveau.