CLI du runner

Le binaire fluhoms-runner sert à la fois de service (mode serve) et d'outil de pilotage en ligne de commande. Toutes les commandes de pilotage (register, status, version, stop, update) dialoguent avec le service local via son API HTTP (port 2024 par défaut) : elles supposent qu'un runner tourne déjà sur la machine.

fluhoms-runner <commande> [options]

fluhoms-runner --help affiche l'aide ; fluhoms-runner --version la version du binaire.

serve

fluhoms-runner serve

Démarre le runner en mode service : API HTTP locale + connexion WebSocket sortante vers la plateforme, avec reconnexion automatique. C'est le processus qui exécute les pipelines. Refuse de démarrer si une autre instance écoute déjà sur le port configuré.

Alias : s, -s, --service (compatibilité avec les anciens installeurs).

register

fluhoms-runner register <code>

Enregistre le runner auprès du serveur Fluhoms avec un code d'enregistrement généré dans l'application (page Runners → Ajouter un runner). Génère une paire de clés RSA-3072, envoie la clé publique au serveur et stocke les identifiants localement. Voir Enregistrer un runner.

status

fluhoms-runner status [--json]

Affiche l'état du service local : statut (running, stopped, error), message, enregistrement effectué ou non, version. --json sort le résultat brut en JSON (pratique pour un superviseur externe). Si aucun service ne répond, la commande affiche « Runner is not running. ».

● Status:     running
  Message:    Connected to gateway
  Registered: true
  Version:    1.4.2

version

fluhoms-runner version

Affiche la version du service en cours d'exécution (interrogée via l'API locale) ; elle peut différer de celle du binaire appelant juste après une mise à jour.

stop

fluhoms-runner stop

Arrête proprement l'instance en cours d'exécution sur la machine. Si aucun runner ne tourne, la commande l'indique et ne fait rien.

update

fluhoms-runner update [--check] [--yes]

Vérifie la disponibilité d'une mise à jour auprès du service configuré (UPDATE_URL) et, le cas échéant, télécharge l'installeur, arrête le service et lance l'installation. Le service est relancé automatiquement par l'installeur.

Option	Effet
`-c`, `--check`	Vérifie seulement, sans installer
`-y`, `--yes`	Installe sans demander de confirmation

Voir aussi

Installer le runner : installation et mode service ;
Configuration du runner : variables d'environnement (PORT, API_URL, UPDATE_URL…).

serve​

register​

status​

version​

stop​

update​

Voir aussi​