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 48f12958cf
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
30 changed files with 271 additions and 190 deletions

View file

@ -10,7 +10,6 @@ VPC, subnets et VM partagent le même jeu d'états.
creating --> running
creating --> error
running --> deleting
running --> error
deleting --> deleted
deleting --> error
error --> deleting
@ -27,7 +26,9 @@ VPC, subnets et VM partagent le même jeu d'états.
* - ``running``
- la ressource existe sur le système
* - ``error``
- ``Execute`` a échoué ; état **terminal**, il n'y a pas de reprise automatique
- ``Execute`` a échoué, ou la migration du démarrage a trouvé la ressource en ``creating`` ou
``deleting`` ; état **terminal**, il n'y a pas de reprise automatique. Une ressource
``running`` ne passe jamais en ``error``
* - ``deleting``
- suppression en cours
* - ``deleted``

View file

@ -20,14 +20,14 @@ deux processus ne doivent pas partager une même instance.
Documents servis
----------------
Chaque document suit la même règle :
Quatre documents sont servis : ``meta-data``, ``user-data``, ``network-config`` et
``vendor-data``. Seul ``user-data`` vient de l'appelant :
* fourni par l'appelant → servi **verbatim**, l'agent n'interprète rien ;
* absent → le template par défaut est rendu ;
* fourni **vide** → servi vide.
* ``user_data`` fourni → servi **verbatim**, après décodage base64 ; l'agent n'interprète rien ;
* ``user_data`` absent ou **vide** → ``user-data`` servi vide : les deux cas sont équivalents.
Les deux derniers cas sont distincts, et c'est délibéré : fournir une chaîne vide est une façon
explicite de neutraliser un document.
``meta-data``, ``network-config`` et ``vendor-data`` sont **toujours** rendus depuis les templates
de l'agent ; ``vendor-data`` crée le compte ``syonad`` à partir de ``password`` et ``sshkey``.
Champs de ``metadata``
----------------------

View file

@ -149,11 +149,12 @@ Routes annoncées aux VM
-----------------------
Les routes sont poussées par DHCP, dans l'**option 121** (routes statiques sans classe,
RFC 3442). Trois entrées y figurent :
RFC 3442). Trois entrées au plus y figurent :
#. la route ``/32`` vers ``169.254.169.254``, le serveur de metadata ;
#. la route vers le CIDR du VPC ;
#. la route par défaut ``0.0.0.0/0``.
#. la route vers le CIDR du VPC, **sauf en mode** ``bridge`` ;
#. la route par défaut ``0.0.0.0/0``, **sur l'interface** ``primary`` **seulement** : les autres
interfaces d'une VM n'en reçoivent pas.
.. important::
@ -163,8 +164,8 @@ RFC 3442). Trois entrées y figurent :
Route par défaut : ``default_route`` et ``gateway``
----------------------------------------------------------
Une route par défaut est **toujours** annoncée. Le champ ``default_route`` ne choisit que son
next-hop :
Une route par défaut est **toujours** annoncée à l'interface ``primary`` d'une VM, et à elle
seule. Le champ ``default_route`` ne choisit que son next-hop :
``default_route: false`` (défaut)
next-hop = ``interface_ip`` du subnet, la gateway calculée en ``vxlan``.
@ -178,7 +179,7 @@ subnet relèvent de l'appelant. Fourni avec ``default_route: false``, il est ign
Dans tous les modes sauf ``bridge``, la route vers le CIDR du VPC garde ``interface_ip`` comme
next-hop : sur un subnet à IP publique, le trafic interne ne doit pas sortir par la gateway
publique.
publique. En mode ``bridge``, cette route n'est pas annoncée du tout.
Pourquoi la route ``/32`` vers le serveur de metadata est indispensable
----------------------------------------------------------------------------

View file

@ -18,6 +18,12 @@ VPC
Un VPC est un **network namespace** portant un espace d'adressage (``cidr``). C'est l'unité
d'isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d'adresses.
À la création, l'agent relie le netns au bridge ``br-public`` de l'host par un veth
``vp-<id>-e`` (côté host) ↔ ``vp-<id>-i`` (côté netns, rattaché à un ``br-public`` propre au
netns). Ce nom de bridge est **en dur** : l'host doit porter un bridge ``br-public``, celui que
crée ``deploy.sh -i`` avec la valeur par défaut de ``-P`` (:doc:`/demarrage/installation`) ;
sans lui, toute création de VPC échoue.
Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.
Routage entre hyperviseurs : ``l3vni``
@ -112,6 +118,9 @@ depuis le subnet, leur source canonique. Le schéma complet des clés est dans
Nommage
-------
L'API est machine-to-machine : elle **ne valide pas** les conventions de nommage, à l'exception
du motif documenté pour les VPC (``vp-…``). Les exemples de cette documentation suivent la
convention ``vp-`` / ``sn-`` / ``i-``, mais c'est à l'appelant de la faire respecter.
L'API est machine-to-machine : elle **ne valide aucun nommage**, pas même le motif ``vp-…``
indiqué par la spécification pour les VPC. Une contrainte est pourtant réelle : le nom d'un VPC
ou d'un subnet doit **contenir un « - »**, car l'identifiant système (``vp-<id>-e``, ``br-<id>``,
``gw-<id>``…) est ce qui suit le premier tiret. Un nom sans tiret fait paniquer l'agent. Les
exemples de cette documentation suivent la convention ``vp-`` / ``sn-`` / ``i-``, mais c'est à
l'appelant de la faire respecter.