Schéma des clés =============== Toutes les valeurs stockées dans Badger sont des **chaînes plates** : une clé, une valeur, pas de sérialisation structurée. .. code-block:: text vpc//state → creating | running | error | deleting | deleted vpc//cidr → vpc//l3vni → (optionnel : VPC routé par L3VNI) subnet//state → creating | running | error | deleting | deleted subnet//vpc → subnet//mode → vxlan | bridge | public_ip subnet//vxlan_id → (mode vxlan uniquement) subnet//cidr → subnet//interface_ip → (gateway ; calculée en vxlan : broadcast-1) subnet//relay_ip → (mode vxlan, calculée : broadcast-2) subnet//local_iface → subnet//default_route → "true" | "false" subnet//gateway → (optionnel) subnet//dhcp/ → vm//state → creating | running | error | deleting | deleted vm//nic//subnet → (une interface par index, ordre du tableau interfaces) vm//nic//ip → vm//nic//primary → "true" (exactement une interface ; absent sur les autres) vm//nic//tap_id → (alloué au premier démarrage, puis conservé) vm//metadata_port → vm//disk/ → (une clé par disque : sda, vda, …) vm//memory → (Mo) vm//cpus → vm//uefi → "true" (absent si SeaBIOS) vm//password → (optionnel — un hash, pas un mot de passe) vm//sshkey → (optionnel) vm//metadata/ → (optionnel : user-data, vendor-data, …) Règles ------ **Pas de duplication.** Une ressource ne stocke que ce qui lui est propre. Une interface de VM garde le lien ``vm//nic//subnet`` ; le VPC, le mode, le bridge et l'``interface_ip`` sont lus depuis le subnet, leur source canonique. De même, la L3VNI d'un VPC n'est stockée que sous ``vpc//l3vni`` : RT, RD, MAC de routeur et table de routage en sont calculés. **Ancien schéma des VM.** Avant le multi-interfaces, une VM portait directement ``subnet``, ``ip`` et ``tap_id``. L'agent les migre au démarrage vers ``nic/0/…``, marquée ``primary``, avant d'ouvrir son API ; une VM qui a déjà des clés ``nic/`` est laissée telle quelle. **Les états passent par ``state``.** Toujours ``state.Set`` / ``state.Get`` : ``Set`` refuse une valeur hors énumération, ``Get`` refuse de retourner une valeur non reconnue. ``error`` n'est écrit que par ``Dispatcher.Dispatch``, via ``cmd.Key()``. **Tout entier lu depuis la base peut être corrompu.** Les erreurs de conversion sont retournées, jamais ignorées : une valeur absente ou illisible est un état d'erreur réel. **Un seul ouvreur.** L'agent est le seul processus à ouvrir la base. Le serveur de metadata lit des fichiers écrits par l'agent sous ``metadata.run_dir``, jamais Badger.