Orchestrateur : agents reliés par un broker (register, ordres, événements), piloté par Terraform/OpenTofu #72
Labels
No labels
bug fix
feature implementation
new feature
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
syonad/two#72
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Objectif
Concevoir l'orchestrateur de two et son lien avec les agents par un broker de messages (MQTT : Mosquitto, et/ou RabbitMQ avec son plugin MQTT). L'orchestrateur est piloté par Terraform / OpenTofu (provider dédié) ; twoctl (#71) continue de parler directement aux agents par tunnel SSH.
Ce ticket porte la conception. L'implémentation sera découpée ensuite.
Modèle
Les agents ouvrent la connexion vers le broker (sortante uniquement, aucun port à ouvrir sur les hyperviseurs) :
registerapi/agent.yaml: un ordre est le même JSON qu'un POST de l'API locale. Le contrat reste unique (documentation des files possible en AsyncAPI, qui réutilise les schémas OpenAPI).internal/agentapi(#71) avec un transport broker.Frontière de confiance
L'agent fait confiance à son appelant et ne valide pas ses entrées. Avec un broker, quiconque peut publier dans la file d'ordres d'un agent contrôle l'hyperviseur : le broker devient la frontière de confiance.
registerauthentifié, sinon n'importe quel hôte peut s'inscrire et recevoir des ordres et des données (user_datades VM, clés).registeret les événements ; seul l'orchestrateur publie des ordres.api/agent.yamlavant publication, comme twoctl.Points à trancher
127.0.0.1pour twoctl).Liens
#71 (twoctl,
internal/agentapi), #39 (connaissance de l'hôte), #44 (Web UI).Passerelles NAT des VPC : placement et bascule (2026-10-25)
Décidé sur #42 : l'orchestrateur place la passerelle NAT de chaque VPC qui autorise Internet, et la replace sur un autre hôte quand le sien est perdu (N1), par l'API de l'agent. L'agent ne détecte aucune panne. Avant l'orchestrateur, ce replacement est fait à la main via twoctl (#71).