Agents

Un agent est le composant qui exécute réellement vos processus. Par défaut, Runeya démarre un agent local automatiquement.

Rôle de l'agent

Le serveur Runeya délègue l'exécution des processus à un agent :

Server ──HTTP/Bearer──► Agent ──execa──► Votre processus

L'agent est stateless : il ne persiste rien sur disque. Toute la configuration est gérée par le serveur.

Agent local (automatique)

Au démarrage, Runeya lance automatiquement un agent local sur localhost:9546. Tous vos services lui sont assignés par défaut.

Vous n'avez rien à configurer pour le cas standard.

Agents distants (futur)

Des agents sur d'autres machines seront supportés dans une version future, permettant de contrôler des processus distants depuis l'interface centrale.

Sécurité

• L'agent génère une passphrase aléatoire (32 bytes) au démarrage
• Toutes les requêtes server → agent doivent inclure Authorization: Bearer <passphrase>
• L'agent ne bind que sur 127.0.0.1 par défaut
• La passphrase est stockée chiffrée dans agents.json

Déploiement lazy

Le serveur ne pousse pas les configurations de services à l'agent au démarrage. Un service n'est déployé sur l'agent que lorsqu'il est démarré pour la première fois. Cela évite un travail inutile pour les services jamais lancés.

Santé de l'agent

L'interface affiche l'état de connexion de chaque agent en temps réel via WebSocket. Un indicateur coloré montre si l'agent répond correctement.