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:
parent
c5d7855a51
commit
48f12958cf
30 changed files with 271 additions and 190 deletions
|
|
@ -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``
|
||||
|
|
|
|||
|
|
@ -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``
|
||||
----------------------
|
||||
|
|
|
|||
|
|
@ -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
|
||||
----------------------------------------------------------------------------
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue