f-80: doc: commandes, chemins et codes alignés sur le code, répertoire uefi, route reflectors, schémas régénérés #80

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-23 13:48:15 +02:00
commit 9a3345f258
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
30 changed files with 271 additions and 190 deletions

View file

@ -4,11 +4,6 @@ Invariants et pièges
Contraintes découvertes en production ou en corrigeant des bugs. Les enfreindre casse quelque
chose qui fonctionne, souvent en silence.
.. note::
Cette page reprend la section « Invariants et pièges » de ``CLAUDE.md``, qui reste la
référence de développement et fait foi en cas d'écart.
Réseau
------

View file

@ -2,8 +2,7 @@ Architecture
============
L'organisation interne de l'agent : découpage en paquets, stockage, et contraintes à ne pas
enfreindre. Ces pages s'adressent à qui modifie le code ; ``CLAUDE.md``, à la racine du dépôt,
reste la référence de développement et fait foi en cas d'écart.
enfreindre. Ces pages s'adressent à qui modifie le code.
.. toctree::
:maxdepth: 1

View file

@ -58,16 +58,28 @@ Paquets
- cycle de vie d'une VM : tap, iptables, metadata, qemu
* - ``internal/dhcp``
- plan d'adressage ip → mac, et configurations dnsmasq du backend historique
* - ``internal/dhcpbackend``
- interface commune aux deux backends DHCP (``dnsmasq`` et ``two``), choisie par
``dhcp.backend``
* - ``internal/dhcpd``
- moteur du serveur DHCP intégré : réservations en mémoire, réponses, écoute
* - ``internal/api/dhcp``, ``internal/client/dhcp``
- protocole de la socket de contrôle du serveur DHCP intégré (``set-host``, ``probe``,
``get-state``…), côté serveur et côté agent
* - ``internal/metadata``
- serveur de metadata cloud-init et ses templates
* - ``internal/watchdog``
- vérification périodique en lecture seule
* - ``internal/watchdog/notify``
- émission des écarts relevés par le watchdog (journal)
* - ``internal/config/agent``
- chargement par viper — tags ``mapstructure``, jamais ``yaml``
* - ``internal/prometheus/agent``
- collector des métriques ``syonad_*``
* - ``pkg/db/kv``
- wrapper Badger ; toutes les valeurs sont des chaînes plates
* - ``pkg/db/statefile``
- fichier d'état JSON typé, écrit de façon atomique, utilisé par le backend DHCP ``two``
* - ``pkg/worker``
- pool de goroutines sur canal
* - ``pkg/systemd``