docs: build de 9ab730a738

2026-09-09 22:00:09 +00:00 · 2026-09-09 22:00:09 +00:00 · ff5220f181
commit ff5220f181
parent 02f1aaebdf
382 changed files with 64868 additions and 4 deletions
--- a/0.2.0rc002/_sources/architecture/stockage.rst
+++ b/0.2.0rc002/_sources/architecture/stockage.rst
@ -0,0 +1,51 @@
+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/<name>/state             → creating | running | error | deleting | deleted
+   vpc/<name>/cidr              → <cidr>
+
+   subnet/<name>/state          → creating | running | error | deleting | deleted
+   subnet/<name>/vpc            → <vpc-name>
+   subnet/<name>/mode           → vxlan | bridge | public_ip
+   subnet/<name>/vxlan_id       → <id>            (mode vxlan uniquement)
+   subnet/<name>/cidr           → <cidr>
+   subnet/<name>/interface_ip   → <ip>            (gateway, portée par br-<subnetID>)
+   subnet/<name>/local_iface    → <bridge-name>
+   subnet/<name>/default_route  → "true" | "false"
+   subnet/<name>/gateway        → <ip>            (optionnel)
+   subnet/<name>/dhcp/<ip>      → <mac>
+
+   vm/<name>/state              → creating | running | error | deleting | deleted
+   vm/<name>/subnet             → <subnet-name>
+   vm/<name>/tap_id             → <int>
+   vm/<name>/ip                 → <ip>
+   vm/<name>/metadata_port      → <port>
+   vm/<name>/disk/<dev>         → <path>          (une clé par disque : sda, vda, …)
+   vm/<name>/memory             → <int>           (Mo)
+   vm/<name>/cpus               → <int>
+   vm/<name>/uefi               → "true"          (absent si SeaBIOS)
+   vm/<name>/password           → <hash>          (optionnel — un hash, pas un mot de passe)
+   vm/<name>/sshkey             → <pubkey>        (optionnel)
+   vm/<name>/metadata/<document> → <contenu brut> (optionnel : user-data, vendor-data, …)
+
+Règles
+------
+
+**Pas de duplication.** Une ressource ne stocke que ce qui lui est propre. Une VM garde le lien
+``vm/<name>/subnet`` ; le VPC, le bridge et l'``interface_ip`` sont lus depuis le subnet, leur
+source canonique.
+
+**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.