Aller au contenu principal

Enregistrer un runner

Un runner naît sur la plateforme et prend corps sur une machine. Trois étapes, et vous n'avez aucun code à recopier : le paramétrage voyage dans un fichier chiffré.

flowchart LR
  A["Déclaré<br/><small>sur la plateforme</small>"] --> B["Pris en charge<br/><small>une machine s'en charge</small>"]
  B --> C["Installé<br/><small>binaires et Python posés</small>"]

Ces trois états sont visibles des deux côtés : sur la page Runners comme dans le gestionnaire. Ils répondent à une question que rien ne tranchait auparavant — ce runner existe-t-il vraiment quelque part, ou seulement sur le papier ?

1. Déclarer le runner​

Page Runners, bouton Ajouter un runner. Renseignez :

  • Nom et description ;
  • Portée :
    • Utilisateur : visible de vous seul ;
    • Entreprise : partagé, réservé aux administrateurs.

À la création, le runner est déclaré : il existe sur la plateforme, aucune machine ne s'en charge encore.

2. Télécharger son paramétrage​

Depuis la carte du runner, Télécharger le paramétrage. Vous obtenez un fichier <nom>.runnerfluhoms — ou <nom>.dev.runnerfluhoms hors production, le canal figurant dans le nom.

Ce fichier est chiffré et contient tout ce qu'il faut : l'adresse de la plateforme, l'identité du runner et son code d'enregistrement.

Un paramétrage périme le précédent

Chaque téléchargement régénère le code d'enregistrement. Un fichier obtenu auparavant cesse alors de fonctionner. Ne téléchargez qu'au moment de vous en servir.

3. L'appliquer sur la machine​

Trois manières, au choix. Le gestionnaire doit être installé sur la machine cible.

Double-clic. Le gestionnaire s'ouvre sur le paramétrage, vous demande où installer le runner, puis pose l'exécutable et l'environnement Python.

Depuis le navigateur. Le lien Ouvrir dans le gestionnaire déclenche l'application sans passer par un téléchargement.

En ligne de commande.

fluhoms runner enroll mon-runner.runnerfluhoms --path /opt/fluhoms

Dès que le gestionnaire prend le runner en charge, la plateforme l'affiche comme pris en charge, puis suit la progression de l'installation. Vous n'avez pas à revenir dire que c'est fait.

Un runner ne s'enrôle qu'à un seul endroit

Appliquer un paramétrage sur une seconde machine y déplace le runner : la première perd son enregistrement et cesse d'exécuter ses traitements. Le gestionnaire vous en avertit lorsque le runner est déjà installé ailleurs.

Vérifier​

Le runner apparaît en ligne dès qu'il établit sa connexion — sortante, sans aucune configuration réseau entrante de votre part.

Côté machine :

fluhoms runner health mon-runner

Le diagnostic couvre ce que la plateforme ne voit pas : l'environnement Python répond-il, des rapports d'exécution attendent-ils d'être renvoyés, le runner est-il joignable localement.

Réparer un enregistrement perdu​

Machine réinstallée, dossier de données effacé : téléchargez simplement un nouveau paramétrage et appliquez-le. L'ancien code est invalidé au passage.

Pour reprendre une installation antérieure au gestionnaire, sans la ré-enregistrer :

fluhoms runner adopt --name default

Le dossier de données n'est pas touché et les identifiants restent valables.

Et ensuite ?​