f-39: doc: connaissance de l'hôte, notes 0.3.0 #39

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-31 15:19:59 +01:00
commit 50bc2497ec
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
5 changed files with 45 additions and 0 deletions

View file

@ -44,6 +44,8 @@ Paquets
``/24`` et ``/32``
* - ``internal/frr``
- génération des commandes FRR, seul point d'appel à ``vtysh``
* - ``internal/host``
- connaissance de l'hôte : faits lus au démarrage (``/register``), état mesuré périodiquement en mémoire (``/ping``)
* - ``internal/sysctl``
- écriture sous ``/proc/sys``, dans un netns si besoin
* - ``internal/netns``

View file

@ -320,6 +320,10 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé
- machine d'états — 409 pendant creating, suppression depuis error, sockets QEMU d'une VM en error retirés, dépendances VM → subnet → VPC, suppression d'un subnet en attente de ses VM, arrêt d'une VM juste démarrée par renvoi de system_powerdown, recréation sous le même nom
- hv1
- #41, #84, #79
* - ``13-hote``
- connaissance de l'hôte — /register (hostname, CPU, RAM, OS, noyau) lu au démarrage, /ping (version, démarrages de l'hôte et de l'agent, uptime, load) mesuré périodiquement, lecture seule, redémarrage de l'agent distingué de celui de l'hôte
- hv1
- #39
* - ``21-dhcp-two``
- DHCP par le serveur intégré (backend two) — bail, server-id, renouvellement, option 121, un serveur par subnet, démarrages simultanés
- hv1

View file

@ -80,6 +80,7 @@ Exécution des commandes
timeout_subnet_start: 300
timeout_vms_start: 300
poll_interval: 2
host_state_interval: 10
``worker.count`` est le nombre de goroutines qui exécutent les commandes ; ``buffer_size`` le
nombre de commandes en attente au-delà duquel ``Dispatch`` bloque.
@ -101,6 +102,9 @@ La section ``times`` règle, en secondes, les attentes des commandes asynchrones
création d'une VM : attente des subnets de ses interfaces ``running``.
``poll_interval``
pas de toutes ces attentes.
``host_state_interval``
intervalle entre deux mesures de l'état de l'hôte servi par ``GET /ping`` (voir
:doc:`observabilite`).
Chaque valeur doit être strictement positive, et ``next_vms_shutdown`` inférieur à
``timeout_vms_stop`` ; sinon l'agent refuse de démarrer. Les attentes s'enchaînent — une VM,

View file

@ -27,6 +27,31 @@ Les états sont ceux du :doc:`cycle de vie </concepts/cycle-de-vie>`. Une valeur
durable sur ``error`` est l'alerte la plus utile à poser ; une valeur durable sur ``creating``
ou ``deleting`` signale une opération qui n'aboutit pas.
Connaissance de l'hôte
----------------------
Deux routes de l'API de l'agent, en lecture seule (voir :doc:`api-agent/reference`) :
``GET /register``
ce qui ne change pas tant que l'hôte tourne : hostname, CPU (fabricant, modèle, sockets,
cœurs, threads), RAM totale, OS (``/etc/os-release``) et noyau. Lu une fois au démarrage de
l'agent ; si la lecture échoue, l'agent démarre quand même, journalise ``host facts
unavailable`` et la route répond 503 avec l'erreur.
``GET /ping``
l'état courant : version de l'agent, démarrage de l'hôte (``boot_time``) et de l'agent
(``agent_start_time``), uptime de l'hôte et load sur 1, 5 et 15 minutes. Mesuré au démarrage
puis toutes les ``times.host_state_interval`` secondes (10 par défaut), gardé en mémoire ;
``collected_at`` donne l'heure de la mesure. 503 tant qu'aucune mesure n'a réussi ; une mesure
en échec est journalisée (``host state collection failed``) et la précédente reste servie.
Les dates sont des timestamps Unix en secondes. Un ``boot_time`` qui change signale un
redémarrage de l'hôte, un ``agent_start_time`` seul un redémarrage de l'agent ;
``boot_time`` + ``uptime_seconds`` donne l'horloge de l'hôte au moment de la mesure.
La version de l'agent est injectée au build : le tag pour une release, le commit court
(suffixé ``-dirty`` si l'arbre avait des modifications) pour les binaires de test du lab,
``undefined`` sinon. Elle figure aussi dans la ligne ``starting agent`` du journal.
Watchdog
--------

View file

@ -113,6 +113,16 @@
- Une IP flottante est refusée (409) sur une interface d'un subnet `public_ip`. Le watchdog
contrôle les subnets `public_ip` comme les subnets `bridge`
**Connaissance de l'hôte (#39)**
- `GET /register` : hostname, CPU (fabricant, modèle, sockets, cœurs, threads), RAM totale, OS
et noyau, lus au démarrage de l'agent (503 si la lecture a échoué)
- `GET /ping` : version de l'agent, démarrages de l'hôte et de l'agent (timestamps Unix),
uptime de l'hôte et load, mesurés toutes les `times.host_state_interval` secondes (10 par
défaut) et gardés en mémoire, avec l'heure de la mesure (`collected_at`)
- **L'agent connaît sa version** : injectée au build (tag de la release), affichée dans
`/ping` et dans la ligne `starting agent` du journal
## Correctifs
- **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait