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
|
|
@ -31,10 +31,12 @@ depuis la release, et les vérifie contre le manifeste ``SHA256SUMS``.
|
|||
- Défaut
|
||||
* - ``-t <tag>``
|
||||
- déployer une release donnée
|
||||
- dernière
|
||||
* - ``-b <branche>``
|
||||
- branche utilisée pour l'auto-mise à jour du script
|
||||
- ``main``
|
||||
- dernière publiée, **préversions comprises**
|
||||
* - ``-b <branche>/``
|
||||
- branche d'où viennent l'auto-mise à jour du script et les scripts de ``-i`` ; les
|
||||
binaires viennent toujours d'une release. Le ``/`` final est **obligatoire** : l'URL est
|
||||
concaténée sans séparateur (``-b dev`` donne ``…/branch/devscripts/…``)
|
||||
- ``main/``
|
||||
* - ``-p <profil>``
|
||||
- profil d'host ; seul ``kvm`` installe les units de l'agent
|
||||
- ``kvm``
|
||||
|
|
@ -48,7 +50,8 @@ depuis la release, et les vérifie contre le manifeste ``SHA256SUMS``.
|
|||
- bridge principal, auquel l'uplink est rattaché
|
||||
- ``br-000000``
|
||||
* - ``-P <bridge>``
|
||||
- bridge supplémentaire, créé vide et réservé
|
||||
- bridge supplémentaire, créé vide et réservé ; garder ``br-public``, nom attendu par
|
||||
l'agent (voir ci-dessous)
|
||||
- ``br-public``
|
||||
* - ``-R <secondes>``
|
||||
- délai avant le redémarrage de secours pendant la migration réseau
|
||||
|
|
@ -89,6 +92,10 @@ ne se provisionne pas. Contrepartie assumée : tout le trafic inter-VM traverse
|
|||
**Réseau** — création du bridge réservé, puis rattachement de l'uplink au bridge principal,
|
||||
l'adresse et la route par défaut étant déplacées de l'interface physique vers le bridge.
|
||||
|
||||
Le nom ``br-public`` est **en dur dans l'agent** : chaque VPC ``vp-<id>`` y raccorde un veth
|
||||
``vp-<id>-e`` côté host, dont l'autre extrémité ``vp-<id>-i`` rejoint un ``br-public`` créé dans
|
||||
le netns du VPC. Avec un autre nom passé à ``-P``, toute création de VPC échoue.
|
||||
|
||||
.. danger::
|
||||
|
||||
La migration réseau **coupe le réseau de l'host si elle échoue à mi-parcours**, sans console
|
||||
|
|
@ -124,14 +131,15 @@ Binaires installés
|
|||
- serveur de metadata cloud-init, une instance par VM dans le netns du VPC
|
||||
- ``-conf``
|
||||
* - ``db``
|
||||
- inspection de la base clé-valeur en ligne de commande
|
||||
- inspection de la base clé-valeur en ligne de commande ; **ni publié ni déployé** par
|
||||
``deploy.sh``, à compiler depuis les sources (:doc:`/exploitation/observabilite`)
|
||||
- ``-conf``
|
||||
* - ``dhcp``
|
||||
- serveur DHCP intégré, une instance par subnet dans le netns du VPC ; démarré uniquement
|
||||
avec ``dhcp.backend: two``
|
||||
- ``-conf``
|
||||
|
||||
Les quatre partagent le même fichier, ``/etc/two/agent.yml`` — voir
|
||||
Les quatre lisent le même fichier, ``/etc/two/agent.yml`` — voir
|
||||
:doc:`/exploitation/configuration`. ``dhcp`` reçoit en plus son bridge et ses deux chemins de
|
||||
fichiers en paramètres, posés par son script d'enrobage.
|
||||
|
||||
|
|
|
|||
|
|
@ -14,16 +14,19 @@ Ce que l'on construit
|
|||
|
||||
graph LR
|
||||
subgraph netns vp-admin
|
||||
BR["br-sn000001<br/>10.1.1.254"]
|
||||
BR["br-000001<br/>10.1.1.253"]
|
||||
GW["gw-000001<br/>gateway 10.1.1.254"]
|
||||
MD["metadata@i-web<br/>169.254.169.254"]
|
||||
end
|
||||
VM["VM i-web<br/>10.1.1.2"] --- BR
|
||||
BR --- MD
|
||||
BR --- VXLAN["VXLAN vni 1<br/>br-000000"]
|
||||
BR --- GW
|
||||
GW --- MD
|
||||
BR --- VXLAN["VXLAN vni 65537<br/>br-000000"]
|
||||
|
||||
Le VPC est un network namespace ; le subnet y pose un bridge porteur de la gateway ; la VM s'y
|
||||
raccroche par un tap, reçoit son adresse en DHCP et son cloud-init depuis le serveur de metadata
|
||||
du netns.
|
||||
Le VPC est un network namespace ; le subnet y pose un bridge ``br-000001`` — ``br-`` suivi de ce
|
||||
qui suit le premier tiret du nom du subnet — porteur de l'adresse d'émission, et un macvlan
|
||||
``gw-000001`` porteur de la gateway ; la VM se raccroche au bridge par un tap, reçoit son
|
||||
adresse en DHCP et son cloud-init depuis le serveur de metadata du netns.
|
||||
|
||||
1. Le VPC
|
||||
---------
|
||||
|
|
@ -43,8 +46,10 @@ La réponse est un **202** : la création est acceptée, pas terminée.
|
|||
|
||||
curl -s http://127.0.0.1:8080/vpcs/vp-admin
|
||||
|
||||
Attendez ``"state": "running"`` avant l'étape suivante — un subnet dont le VPC parent n'est pas
|
||||
prêt est refusé en **422**. Le modèle d'attente est décrit dans :doc:`/exploitation/api-agent/asynchronisme`.
|
||||
Un subnet peut être demandé dès maintenant : il est accepté tant que le VPC est en ``creating``
|
||||
ou ``running``, et sa création attend que le VPC soit ``running``, dans la limite de
|
||||
``dispatcher.timeout_seconds``. Il n'est refusé en **422** que si le VPC est absent, en ``error``
|
||||
ou en ``deleting``. Le modèle d'attente est décrit dans :doc:`/exploitation/api-agent/asynchronisme`.
|
||||
|
||||
2. Le subnet
|
||||
------------
|
||||
|
|
@ -56,7 +61,7 @@ prêt est refusé en **422**. Le modèle d'attente est décrit dans :doc:`/explo
|
|||
-d '{"name": "sn-000001",
|
||||
"vpc": "vp-admin",
|
||||
"mode": "vxlan",
|
||||
"vxlan_id": 1,
|
||||
"vxlan_id": 65537,
|
||||
"iface_type": "vms",
|
||||
"cidr": "10.1.0.0/23"}'
|
||||
|
||||
|
|
@ -140,16 +145,16 @@ cloud-init, lui, se déroule dans le guest ; on l'observe par la console série
|
|||
|
||||
socat -,raw,echo=0 UNIX-CONNECT:/run/two/vms/serial/i-web.sock
|
||||
|
||||
Puis, depuis l'host :
|
||||
Puis, depuis l'host, en passant par le netns du VPC :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ssh syonad@10.1.1.2
|
||||
ip netns exec vp-admin ssh syonad@10.1.1.2
|
||||
|
||||
.. note::
|
||||
|
||||
En mode ``vxlan``, la VM vit dans le netns du VPC : elle n'est pas joignable depuis l'host
|
||||
sans route explicite. En mode ``bridge``, elle l'est directement.
|
||||
sans route explicite, d'où le ``ip netns exec``. En mode ``bridge``, elle l'est directement.
|
||||
|
||||
5. Supprimer
|
||||
------------
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue