Migrer une station de la v1.0 vers le CLI

Le CLI TofuPilot est la nouvelle façon de faire tourner une station de test. C'est le runtime derrière les Stations v2.0, et il remplace la station v1.0 : l'application de bureau qui tournait sur le banc, récupérait les déploiements et exécutait les procédures en local. Le CLI fait le même travail, avec une installation en une commande, des déploiements automatiques depuis Git et la même UI opérateur en direct. Ce guide montre comment y basculer un banc.

Sur une instance auto-hébergée ? Configurez d'abord le deployer pour que votre instance puisse construire les bundles de station, et activez le serveur temps réel pour que les runs soient diffusés en direct. Suivez Activer le temps réel et les déploiements en auto-hébergé, puis revenez ici. TofuPilot Cloud a déjà les deux activés, vous pouvez donc démarrer tout de suite.

Pourquoi passer au CLI

La station v1.0 était une application de bureau installée sur chaque banc. Les Stations v2.0 tournent sur le CLI TofuPilot, qui conserve tout ce que faisait l'application de bureau et ajoute ce qu'elle ne pouvait pas faire :

• Installation en une commande. Aucun installeur à télécharger par machine. Le CLI s'installe en une seule commande shell depuis la page de configuration de la station et s'enregistre au premier démarrage.
• Déploiement automatique depuis Git. Connectez la procédure à son dépôt GitHub et choisissez une branche (typiquement main) pour le déploiement automatique. Les pushes sur cette branche sont déployés tout seuls vers les bonnes stations. Les autres branches restent manuelles : déployez-les depuis le dashboard quand vous êtes prêt.
• UI opérateur à distance et en kiosque. Pilotez un run depuis le dashboard via le web, ou depuis une UI kiosque locale en plein écran sur le banc. Une UI terminal est également disponible lorsqu'un ingénieur pilote un test de paillasse.
• Pas de connexion au fournisseur Git sur le banc. L'application de bureau synchronisait le code de procédure directement depuis GitHub ou GitLab, donc chaque banc avait besoin d'un accès au fournisseur Git. La liaison du dépôt se fait désormais une seule fois dans le dashboard, et le banc récupère à la place un artefact pré-construit : il ne touche donc jamais à votre dépôt et vous contrôlez entièrement les déploiements depuis le web.
• File d'attente de téléversement tolérante au hors-ligne. Les runs sont mis en file localement sur le banc et téléversés dès que le réseau revient, ainsi une liaison instable ne vous coûte jamais de données.
• S'exécute sans interface, partout. L'application de bureau nécessitait un environnement de bureau. Le CLI tourne sans interface sur un serveur, une machine en rack ou une petite carte monocarte, et fonctionne d'emblée avec les déploiements auto-hébergés.

Étapes de migration

1. Vérifier que la procédure a un déploiement

Le CLI s'exécute à partir d'un artefact construit, la procédure a donc besoin d'un déploiement récent que la nouvelle station pourra récupérer. Sur la page de la procédure dans le dashboard :

• Si la procédure est déjà liée à son dépôt Git (c'est le cas de la plupart des procédures v1.0), déclenchez un nouveau déploiement : poussez sur la branche de déploiement automatique, ou déployez manuellement depuis le dashboard.
• Si elle n'est pas encore liée, liez d'abord le dépôt GitHub ou GitLab, puis déployez.

C'est cette construction que la nouvelle station récupère et exécute.

2. Installer le CLI sur le banc

Ouvrez la page de détail de la station dans le dashboard et copiez sa commande d'installation. Elle est pré-remplie avec le jeton de configuration de la station, et en auto-hébergé elle porte aussi le drapeau --url pointant vers votre instance : copiez-la donc depuis le dashboard plutôt que de la taper à la main. Elle ressemble à ceci :

Exécutez-la une fois sur le banc. Le CLI s'installe, s'enregistre auprès de votre organisation, et la station apparaît en ligne dans le dashboard. Le jeton de configuration expire une heure après son émission ; s'il est périmé, générez-en un nouveau depuis la ligne de la station.

3. Ajuster la configuration de la station

Depuis les paramètres de la station, choisissez les comportements qui correspondent à votre atelier :

• Lancement au démarrage pour que la station soit prête dès la mise sous tension.
• UI kiosque pour un mode opérateur en plein écran, ou UI terminal pour une paillasse d'ingénieur.
• Raccourci bureau pour un lancement en un clic.
• Mise à jour automatique pour garder le CLI à jour entre les runs.

4. Retirer l'application de bureau

Une fois que le banc exécute ses runs via le CLI et que ceux-ci arrivent en direct dans le dashboard, désinstallez l'application de bureau v1.0 de la machine. La station v1.0 est en cours de retrait progressif, et nous contactons chaque équipe encore dessus avec un accompagnement de migration pratique.

C'est terminé. Le prochain run déclenché par un opérateur arrive en direct dans le dashboard, avec les validateurs et les pièces jointes pris en charge par le CLI.