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>
17
README.md
|
|
@ -22,20 +22,20 @@ Options utiles :
|
|||
|
||||
| Option | Effet |
|
||||
|---|---|
|
||||
| `-t <tag>` | déployer une release donnée |
|
||||
| `-b <branche>` | déployer depuis une branche au lieu d'une release |
|
||||
| `-t <tag>` | déployer une release donnée ; sans `-t`, la dernière publiée, préversions comprises |
|
||||
| `-b <branche>/` | branche d'où viennent l'auto-mise à jour du script et le bootstrap (`main/` par défaut, `/` final obligatoire) ; les binaires viennent toujours d'une release |
|
||||
| `-i` | préparer l'host (paquets, noyau, réseau) |
|
||||
| `-u <iface>` | interface physique d'uplink, `eno1` par défaut |
|
||||
| `-B <bridge>` | bridge principal auquel l'uplink est rattaché |
|
||||
| `-d` | dry-run : affiche les commandes sans les exécuter |
|
||||
| `-V` | désactiver la vérification des sommes de contrôle |
|
||||
| `--noverify` | désactiver la vérification des sommes de contrôle |
|
||||
|
||||
Un déploiement relève les instances `dnsmasq@`, `dhcp@` et `metadata@` actives **avant** l'arrêt des
|
||||
services, et les redémarre ensuite — c'est la seule façon de savoir lesquelles relancer.
|
||||
|
||||
## Configuration
|
||||
|
||||
Un seul fichier, `/etc/two/agent.yml`, partagé par les trois binaires. Voir
|
||||
Un seul fichier, `/etc/two/agent.yml`, partagé par les quatre binaires. Voir
|
||||
[`conf/agent/config.exemple.yml`](conf/agent/config.exemple.yml) pour l'ensemble des options :
|
||||
chemins de la base et des sockets QEMU, pool de workers, correspondance des types d'interface vers
|
||||
les bridges physiques, watchdog, API d'administration, journalisation.
|
||||
|
|
@ -49,7 +49,7 @@ curl -X POST http://127.0.0.1:8080/vpcs \
|
|||
|
||||
# Un subnet en VXLAN dans ce VPC
|
||||
curl -X POST http://127.0.0.1:8080/subnets \
|
||||
-d '{"name": "sn-000001", "vpc": "vp-admin", "mode": "vxlan", "vxlan_id": 1,
|
||||
-d '{"name": "sn-000001", "vpc": "vp-admin", "mode": "vxlan", "vxlan_id": 65537,
|
||||
"iface_type": "vms", "cidr": "10.1.0.0/23"}'
|
||||
|
||||
# Une VM, avec une clé SSH et un user-data cloud-init en base64
|
||||
|
|
@ -58,7 +58,7 @@ curl -X POST http://127.0.0.1:8080/vms \
|
|||
"metadata": {"sshkey": "ssh-ed25519 AAAA…",
|
||||
"user_data": "'"$(base64 -w0 < user-data.yml)"'"},
|
||||
"interfaces": [{"subnet": "sn-000001", "ip": "10.1.1.2", "mac": "52:54:00:01:01:02", "primary": true}],
|
||||
"storage": [{"path": "/data/disks/vms/i-web.qcow2", "dev": "vda"}]}'
|
||||
"storage": [{"path": "/var/lib/two/volumes/i-web.qcow2", "dev": "vda"}]}'
|
||||
```
|
||||
|
||||
Les créations sont **asynchrones** : l'API répond `202` et l'état de la ressource passe de
|
||||
|
|
@ -75,9 +75,10 @@ La spécification complète est dans [`api/agent.yaml`](api/agent.yaml).
|
|||
|---|---|
|
||||
| `agent` | processus principal : API, dispatcher, exécution, watchdog |
|
||||
| `metadata` | serveur de metadata cloud-init, une instance par VM dans le netns du VPC |
|
||||
| `db` | inspection de la base clé-valeur en ligne de commande |
|
||||
| `dhcp` | serveur DHCP intégré, une instance par subnet dans le netns du VPC, avec `dhcp.backend: two` |
|
||||
| `db` | inspection de la base clé-valeur en ligne de commande ; ni publié ni déployé, à compiler (`go build ./cmd/db`) |
|
||||
|
||||
L'agent prend `-config`, les deux autres `-conf`.
|
||||
L'agent prend `-config`, les trois autres `-conf`.
|
||||
|
||||
## Versions
|
||||
|
||||
|
|
|
|||
|
|
@ -76,7 +76,7 @@ qemu:
|
|||
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
||||
ovmf_vars_template: "/usr/share/OVMF/OVMF_VARS.fd"
|
||||
# Per-VM UEFI variable store (writable copy, created at start / deleted at stop)
|
||||
uefi_vars_dir: "/run/two/vms/efi"
|
||||
uefi_vars_dir: "/run/two/vms/uefi"
|
||||
# QEMU Unix socket directories
|
||||
serial_dir: "/run/two/vms/serial"
|
||||
monitor_dir: "/run/two/vms/monitor"
|
||||
|
|
|
|||
|
|
@ -11,10 +11,10 @@ pip install -r requirements.txt
|
|||
sphinx-autobuild . "${TMPDIR}/build"
|
||||
```
|
||||
|
||||
Construction simple :
|
||||
Construction simple, avec les mêmes options que la CI (avertissements bloquants) :
|
||||
|
||||
```bash
|
||||
sphinx-build -b html . _build/html
|
||||
sphinx-build -b html -W --keep-going . _build/html
|
||||
```
|
||||
|
||||
La référence de l'API est générée depuis `../api/agent.yaml` : c'est la source unique du
|
||||
|
|
|
|||
|
|
@ -4,11 +4,6 @@ Invariants et pièges
|
|||
Contraintes découvertes en production ou en corrigeant des bugs. Les enfreindre casse quelque
|
||||
chose qui fonctionne, souvent en silence.
|
||||
|
||||
.. note::
|
||||
|
||||
Cette page reprend la section « Invariants et pièges » de ``CLAUDE.md``, qui reste la
|
||||
référence de développement et fait foi en cas d'écart.
|
||||
|
||||
Réseau
|
||||
------
|
||||
|
||||
|
|
|
|||
|
|
@ -2,8 +2,7 @@ Architecture
|
|||
============
|
||||
|
||||
L'organisation interne de l'agent : découpage en paquets, stockage, et contraintes à ne pas
|
||||
enfreindre. Ces pages s'adressent à qui modifie le code ; ``CLAUDE.md``, à la racine du dépôt,
|
||||
reste la référence de développement et fait foi en cas d'écart.
|
||||
enfreindre. Ces pages s'adressent à qui modifie le code.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
|
|
|
|||
|
|
@ -58,16 +58,28 @@ Paquets
|
|||
- cycle de vie d'une VM : tap, iptables, metadata, qemu
|
||||
* - ``internal/dhcp``
|
||||
- plan d'adressage ip → mac, et configurations dnsmasq du backend historique
|
||||
* - ``internal/dhcpbackend``
|
||||
- interface commune aux deux backends DHCP (``dnsmasq`` et ``two``), choisie par
|
||||
``dhcp.backend``
|
||||
* - ``internal/dhcpd``
|
||||
- moteur du serveur DHCP intégré : réservations en mémoire, réponses, écoute
|
||||
* - ``internal/api/dhcp``, ``internal/client/dhcp``
|
||||
- protocole de la socket de contrôle du serveur DHCP intégré (``set-host``, ``probe``,
|
||||
``get-state``…), côté serveur et côté agent
|
||||
* - ``internal/metadata``
|
||||
- serveur de metadata cloud-init et ses templates
|
||||
* - ``internal/watchdog``
|
||||
- vérification périodique en lecture seule
|
||||
* - ``internal/watchdog/notify``
|
||||
- émission des écarts relevés par le watchdog (journal)
|
||||
* - ``internal/config/agent``
|
||||
- chargement par viper — tags ``mapstructure``, jamais ``yaml``
|
||||
* - ``internal/prometheus/agent``
|
||||
- collector des métriques ``syonad_*``
|
||||
* - ``pkg/db/kv``
|
||||
- wrapper Badger ; toutes les valeurs sont des chaînes plates
|
||||
* - ``pkg/db/statefile``
|
||||
- fichier d'état JSON typé, écrit de façon atomique, utilisé par le backend DHCP ``two``
|
||||
* - ``pkg/worker``
|
||||
- pool de goroutines sur canal
|
||||
* - ``pkg/systemd``
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
------------
|
||||
|
|
|
|||
|
|
@ -24,9 +24,9 @@ Vue d'ensemble
|
|||
(BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés :
|
||||
élément à venir, avec son ticket.
|
||||
|
||||
Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés
|
||||
en eBGP entre eux et aux **routeurs de bordure**. Ce qui n'existe pas encore est décrit sur son
|
||||
ticket :
|
||||
Plusieurs clusters, chacun avec son underlay et ses deux routeurs, sont reliés en eBGP entre eux
|
||||
et aux **routeurs de bordure** ; les route reflectors sont décrits plus bas. Ce qui n'existe pas
|
||||
encore est décrit sur son ticket :
|
||||
|
||||
* **Internet** (`#31 <https://git.g3e.fr/syonad/two/issues/31>`_,
|
||||
`#42 <https://git.g3e.fr/syonad/two/issues/42>`_). Les bordures partagent avec les hyperviseurs
|
||||
|
|
@ -41,12 +41,19 @@ ticket :
|
|||
|
||||
* **Orchestration** (`#72 <https://git.g3e.fr/syonad/two/issues/72>`_). Le broker et
|
||||
l'orchestrateur sont des VM du VNI 66000, partagé entre clusters. Les agents s'y connectent
|
||||
**en sortie**, par leur passerelle ; les routeurs de chaque cluster les NAT vers le VNI 66000.
|
||||
**en sortie**, par leur passerelle ; les routeurs de chaque cluster les traduisent (NAT) vers le
|
||||
VNI 66000.
|
||||
L'orchestrateur a aussi une patte dans le VNI 66001 : son API est joignable depuis Internet.
|
||||
|
||||
* **Route reflectors.** Un par cluster, pour qu'un incident sur un cluster ne coupe pas les deux
|
||||
sessions EVPN. Chaque lien entre routeurs et route reflector est en ``169.254.0.0/28``, propre
|
||||
à son cluster.
|
||||
* **Route reflectors.** Au moins un ; deux sont prévus dans l'architecture et dans les exemples
|
||||
(plages d'adresses de :doc:`route-reflector`), placés ici dans deux clusters différents pour
|
||||
qu'un incident sur un cluster ne coupe pas les deux sessions EVPN. Chaque lien entre routeurs
|
||||
et route reflector est en ``169.254.0.0/28``, propre à son cluster. Le ``bgp listen range`` de
|
||||
chaque route reflector doit alors couvrir l'underlay de **tous** les clusters qu'il sert —
|
||||
l'exemple ``rr1.conf`` n'accepte que ``192.168.14.0/24``.
|
||||
|
||||
* **ASN.** Les routeurs de deux clusters étant voisins eBGP, chaque cluster a son propre ASN de
|
||||
routeurs : l'AS 65100 des exemples est la valeur d'**un** cluster.
|
||||
|
||||
Le lab (:doc:`/developpement/lab`) simplifie : un seul cluster, qui porte les deux route
|
||||
reflectors.
|
||||
|
|
@ -79,7 +86,7 @@ Plan de données
|
|||
|
||||
Plan de contrôle
|
||||
ce qui dit à chaque hyperviseur où se trouvent les adresses MAC des autres. C'est le rôle de
|
||||
FRR et du route reflector.
|
||||
FRR et des route reflectors.
|
||||
|
||||
Ce que l'agent suppose déjà en place
|
||||
------------------------------------
|
||||
|
|
@ -111,8 +118,8 @@ apprentissage des adresses MAC depuis le trafic, ni voisin statique configuré.
|
|||
isolé le trafic reste sur le bridge local et cette absence ne se voit pas ; elle apparaît dès
|
||||
le deuxième nœud.
|
||||
|
||||
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et le route reflector qui
|
||||
les fait converger.
|
||||
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et les route reflectors qui
|
||||
les font converger.
|
||||
|
||||
MTU
|
||||
---
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ même nœud. Cette section couvre la mise en place d'un **cluster** complet, dan
|
|||
|
||||
Cet ordre n'est pas indifférent : chaque étape a besoin de la précédente. L'image doit exister
|
||||
avant qu'on puisse démarrer quoi que ce soit ; le réseau doit être en place avant le premier
|
||||
hyperviseur ; le route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
|
||||
hyperviseur ; chaque route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
|
||||
fonctionne.
|
||||
|
||||
Étapes
|
||||
|
|
|
|||
|
|
@ -62,13 +62,13 @@ L'agent en déduit la configuration ci-dessous ; le ``router-id`` est l'adresse
|
|||
Avec une section ``bgp``, l'agent **refuse de démarrer** si ``vtysh`` ne répond pas, et
|
||||
``agent.service`` ne le relance pas. L'ordre au démarrage est donc : migration réseau vers
|
||||
``br-000000``, **puis** FRR, **puis** l'agent. FRR démarré avant la migration peut perdre la
|
||||
route par défaut quand elle change d'interface, et ne plus joindre le route reflector.
|
||||
route par défaut quand elle change d'interface, et ne plus joindre les route reflectors.
|
||||
|
||||
Ce qu'elle établit :
|
||||
|
||||
* **Une session par route reflector**, en iBGP dans l'AS 64600, vers sa loopback
|
||||
(``10.255.255.1``, ``10.255.255.2``), jointe par la passerelle par défaut — le routeur de
|
||||
cluster l'a apprise du route reflector (:doc:`routeurs`). Aucune adresse d'un autre hyperviseur n'est écrite : ajouter
|
||||
cluster l'a apprise de ce route reflector (:doc:`routeurs`). Aucune adresse d'un autre hyperviseur n'est écrite : ajouter
|
||||
un nœud ne touche pas la configuration des autres.
|
||||
* **EVPN seulement** : l'IPv4 unicast n'est pas activé (``no bgp default ipv4-unicast``).
|
||||
``advertise-all-vni`` annonce les VNI de toutes les interfaces VXLAN que FRR voit, et donc
|
||||
|
|
@ -81,9 +81,9 @@ Articulation avec l'agent
|
|||
Rien à configurer à la création d'un subnet : la VXLAN apparaît, FRR la voit et l'annonce, sans
|
||||
action ni redémarrage. Il faut en revanche que la VXLAN porte une **adresse VTEP locale** : sans
|
||||
elle, FRR voit la VNI mais n'annonce rien, et deux hyperviseurs gérés par two ne se joignent pas.
|
||||
L'agent la pose à partir de la release ``0.2.0rc003``
|
||||
(`#51 <https://git.g3e.fr/syonad/two/issues/51>`_) : l'adresse IPv4 primaire du ``local_iface``
|
||||
du subnet.
|
||||
L'agent la pose depuis la version 0.2.0 (préversions comprises à partir de ``0.2.0rc003``,
|
||||
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_, fermé) : l'adresse IPv4 primaire du
|
||||
``local_iface`` du subnet.
|
||||
|
||||
.. note::
|
||||
|
||||
|
|
@ -93,11 +93,10 @@ du subnet.
|
|||
et configuration doivent être posés à chaque démarrage, par le bootstrap ou un mécanisme
|
||||
équivalent (`#52 <https://git.g3e.fr/syonad/two/issues/52>`_) ;
|
||||
* le démarrage à froid, selon que FRR démarre avant ou après l'agent ;
|
||||
* les subnets ``vxlan`` créés avant ``0.2.0rc003``, dont la VXLAN n'a pas d'adresse VTEP
|
||||
locale : les recréer ou poser l'adresse à chaud, à trancher dans
|
||||
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_ ;
|
||||
* les subnets ``vxlan`` créés par une version antérieure, dont la VXLAN n'a pas d'adresse VTEP
|
||||
locale : aucune migration ne la pose, il faut les recréer ;
|
||||
* le cas particulier du **premier** hyperviseur, dont la session ne peut pas s'établir tant
|
||||
que le route reflector n'existe pas.
|
||||
qu'aucun route reflector n'existe.
|
||||
|
||||
Vérifier le plan de données
|
||||
---------------------------
|
||||
|
|
|
|||
|
|
@ -3,9 +3,11 @@ VM route reflector
|
|||
|
||||
Le route reflector est le point de rendez-vous du plan de contrôle : plutôt que de maintenir une
|
||||
session entre chaque paire d'hyperviseurs, chaque hyperviseur ouvre une session vers le route
|
||||
reflector, qui redistribue. Le cluster en compte **deux**, configurés à l'identique hormis leurs
|
||||
adresses : chaque hyperviseur ouvre une session vers chacun, et la perte de l'un ne doit pas
|
||||
interrompre le plan de contrôle (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_).
|
||||
reflector, qui redistribue. Un cluster en compte **au moins un** ; l'architecture et les exemples
|
||||
de cette page en prévoient **deux** (rr1 et rr2, d'où les plages d'adresses ci-dessous),
|
||||
configurés à l'identique hormis leurs adresses : chaque hyperviseur ouvre une session vers chacun,
|
||||
et la perte de l'un n'interrompt pas le plan de contrôle
|
||||
(`#54 <https://git.g3e.fr/syonad/two/issues/54>`_, fermé).
|
||||
|
||||
Il tourne lui-même en machine virtuelle, ce qui crée une dépendance circulaire à traiter
|
||||
explicitement : la VM qui porte le plan de contrôle du cluster est hébergée par le cluster.
|
||||
|
|
@ -84,13 +86,14 @@ Ce qu'elle établit :
|
|||
|
||||
.. warning::
|
||||
|
||||
**Les tunnels ne survivent pas à la perte du route reflector.** Avec un seul route reflector
|
||||
et sans ``graceful-restart``, à l'arrêt de FRR sur le route reflector, la session EVPN des
|
||||
hyperviseurs tombe aussitôt, FRR retire les routes apprises et, avec elles, le VTEP distant et l'entrée d'inondation du VXLAN — **plus
|
||||
aucun paquet ne passe** entre hyperviseurs, à 30 s comme à 90 s. Au redémarrage de FRR sur le
|
||||
route reflector, VTEP distant et trafic reviennent **31 s** plus tard. Le trafic entre VM d'un
|
||||
même hyperviseur n'est pas concerné. La redondance (deux route reflectors) ou
|
||||
``graceful-restart`` sont les deux leviers ; ni l'un ni l'autre n'est encore qualifié.
|
||||
**Les tunnels ne survivent pas à la perte de tous les route reflectors.** Sans
|
||||
``graceful-restart``, quand plus aucun route reflector ne répond, les sessions EVPN des
|
||||
hyperviseurs tombent, FRR retire les routes apprises et, avec elles, le VTEP distant et
|
||||
l'entrée d'inondation du VXLAN : **plus aucun paquet ne passe** entre hyperviseurs, jusqu'au
|
||||
retour d'un route reflector et à la reconvergence des sessions. Le trafic entre VM d'un même
|
||||
hyperviseur n'est pas concerné. Avec deux route reflectors, la perte de l'un est sans effet sur
|
||||
le trafic, à condition qu'ils ne tombent jamais ensemble : **jamais deux route reflectors sur le
|
||||
même hyperviseur**. Les mesures du lab sont dans :doc:`/developpement/lab`.
|
||||
|
||||
.. note::
|
||||
|
||||
|
|
@ -101,8 +104,8 @@ Ce qu'elle établit :
|
|||
autres ou d'un cas particulier — l'image, elle, est l'image golden de :doc:`image-qcow2` ;
|
||||
* le placement des deux VM : jamais sur le même hyperviseur, et de préférence pas sur un
|
||||
hyperviseur dont la perte isolerait l'autre ;
|
||||
* la procédure de reconstruction — l'état du cluster pendant l'absence du route reflector est
|
||||
décrit ci-dessus : plus de trafic entre hyperviseurs ;
|
||||
* la procédure de reconstruction — l'état du cluster pendant l'absence de tous les route
|
||||
reflectors est décrit ci-dessus : plus de trafic entre hyperviseurs ;
|
||||
* la procédure d'amorçage : ce qui fonctionne, et dans quel ordre, quand on démarre un cluster
|
||||
entier depuis zéro — le premier hyperviseur n'a pas de session FRR établie tant que cette VM
|
||||
n'existe pas, cf. :doc:`premier-hyperviseur`.
|
||||
|
|
|
|||
|
|
@ -18,9 +18,10 @@ Routeurs de bordure
|
|||
Routeur de cluster
|
||||
------------------
|
||||
|
||||
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des deux route
|
||||
reflectors, dont il apprend les loopbacks : c'est par lui que chaque hyperviseur joint
|
||||
``10.255.255.1`` et ``10.255.255.2`` pour ouvrir ses sessions EVPN (:doc:`route-reflector`).
|
||||
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des route reflectors
|
||||
— au moins un ; deux sont prévus dans l'architecture et dans les exemples —, dont il apprend les
|
||||
loopbacks : c'est par lui que chaque hyperviseur joint ``10.255.255.1`` et ``10.255.255.2`` pour
|
||||
ouvrir ses sessions EVPN (:doc:`route-reflector`).
|
||||
|
||||
Adressage
|
||||
~~~~~~~~~
|
||||
|
|
@ -33,8 +34,9 @@ Adressage
|
|||
- Interface
|
||||
- Rôle
|
||||
* - ``192.168.14.1/24``
|
||||
- interface du segment des hyperviseurs
|
||||
- passerelle par défaut des hyperviseurs et du route reflector
|
||||
- interface du segment des hyperviseurs, **adresse virtuelle VRRP**
|
||||
- passerelle par défaut des hyperviseurs et des route reflectors, portée par le routeur
|
||||
maître ; chaque routeur a en plus sa propre adresse sur le segment
|
||||
* - ``169.254.0.1/28``
|
||||
- même interface, **adresse secondaire**
|
||||
- lien avec les route reflectors (``169.254.0.3`` et ``.4``) ; ``router-id`` ; le second
|
||||
|
|
@ -60,9 +62,9 @@ Ce qu'elle établit :
|
|||
* **Aucune session avec les hyperviseurs** : le routeur leur sert de passerelle, pas de voisin BGP.
|
||||
|
||||
Celle du second routeur (``test/e2e/topologies/frr/sw2.conf``) ne diffère que par ``hostname`` et
|
||||
``router-id`` (``169.254.0.2``), que les route reflectors déclarent aussi. La redondance des
|
||||
routeurs — et le mécanisme qui fait basculer la passerelle ``192.168.14.1`` — est l'objet de
|
||||
`#54 <https://git.g3e.fr/syonad/two/issues/54>`_.
|
||||
``router-id`` (``169.254.0.2``), que les route reflectors déclarent aussi. Les deux routeurs se
|
||||
partagent la passerelle ``192.168.14.1`` en **VRRP v3** : le maître la porte, l'autre attend, sans
|
||||
préemption (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_, fermé).
|
||||
|
||||
.. note::
|
||||
|
||||
|
|
@ -73,9 +75,8 @@ routeurs — et le mécanisme qui fait basculer la passerelle ``192.168.14.1``
|
|||
|
||||
**À rédiger.** Reste à documenter, faute d'éléments de terrain :
|
||||
|
||||
* pour le routeur de cluster : le matériel employé et sa version de référence ; la redondance
|
||||
— deux routeurs, mécanisme de bascule, comportement attendu pendant une bascule
|
||||
(`#54 <https://git.g3e.fr/syonad/two/issues/54>`_) ;
|
||||
* pour le routeur de cluster : le matériel employé et sa version de référence ; la traduction
|
||||
de la redondance VRRP v3 dans sa configuration ;
|
||||
* pour les routeurs de datacentre et de bordure : tout — équipement, configuration de
|
||||
référence, ce qui est annoncé et filtré à chaque niveau, redondance ;
|
||||
* l'ordre de mise en service, et ce qui doit être opérationnel avant de préparer le premier
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ Lab de test multi-nœud
|
|||
Ce qui fait l'intérêt de two ne se voit qu'à partir de **deux hyperviseurs** : sur un nœud isolé,
|
||||
le trafic reste sur le bridge local et l'absence de plan de contrôle passe inaperçue (voir
|
||||
:doc:`/deploiement/architecture-cluster`). Le lab reproduit la topologie du cluster —
|
||||
hyperviseurs, route reflector, switch L3 — sous forme de VM, sur un serveur physique loué à
|
||||
hyperviseurs, route reflectors, switchs L3 — sous forme de VM, sur un serveur physique loué à
|
||||
l'heure.
|
||||
|
||||
Le pourquoi des choix (serveur physique plutôt que VM cloud, câbles QEMU, MTU 9000, versions) est
|
||||
|
|
@ -17,7 +17,8 @@ comment s'en servir.
|
|||
`labctl <https://git.g3e.fr/syonad/labctl>`_, un dépôt à part, dont two épingle une release.
|
||||
Ce dépôt garde ce qui est propre à two — ses topologies, l'installation de two sur les
|
||||
hyperviseurs, les scénarios et leurs résultats. La redondance du plan de contrôle — deux route
|
||||
reflectors, deux switchs — est l'objet de `#54 <https://git.g3e.fr/syonad/two/issues/54>`_.
|
||||
reflectors, deux switchs en VRRP v3 — est livrée par `#54 <https://git.g3e.fr/syonad/two/issues/54>`_
|
||||
(fermé), et qualifiée par les tests 71 et 72.
|
||||
|
||||
L'outil
|
||||
-------
|
||||
|
|
@ -69,7 +70,7 @@ et ``evpn-3hv.yml`` (trois, celle de la suite). Le format est celui de ``labctl`
|
|||
.. literalinclude:: ../../test/e2e/topologies/evpn-2hv.yml
|
||||
:language: yaml
|
||||
|
||||
Les ASN, la loopback du route reflector, le lien ``169.254.0.0/28`` et le subnet des hyperviseurs
|
||||
Les ASN, les loopbacks des route reflectors, le lien ``169.254.0.0/28`` et le subnet des hyperviseurs
|
||||
de l'exemple sont **ceux de la production** (décision du 2026-10-04, #50) : les fichiers de
|
||||
``test/e2e/topologies/`` restent ainsi au plus près de ce qui tourne réellement. Toutes les adresses y sont
|
||||
**fixées** par ``addresses`` — les switchs en ``.2`` et ``.3``, les route reflectors en ``.4`` et ``.5``,
|
||||
|
|
@ -77,8 +78,9 @@ les hyperviseurs à partir de ``.11`` — pour que le modèle se lise sans le pl
|
|||
de l'ordre de déclaration : le ``frr.conf`` d'un hyperviseur, écrit à la main, porte son adresse en
|
||||
``router-id``. Les deux switchs ``sw1`` et ``sw2`` sont les routeurs du segment (rôle ``router`` de
|
||||
labctl) : la passerelle, la première adresse du segment, est portée en VRRP v3 par celui qui est
|
||||
maître, sans préemption — voir la section du guide de labctl sur les routeurs. Leurs
|
||||
``frr.conf`` ne diffèrent que par ``hostname`` et ``router-id`` ; labctl y ajoute la strophe VRRP.
|
||||
maître, sans préemption (``no vrrp 1 preempt``) — voir la section du guide de labctl sur les
|
||||
routeurs. Leurs ``frr.conf`` ne diffèrent que par ``hostname`` et ``router-id`` ; labctl y ajoute
|
||||
la strophe VRRP.
|
||||
|
||||
Rôles
|
||||
~~~~~
|
||||
|
|
@ -86,8 +88,8 @@ Rôles
|
|||
Les configurations FRR du lab vivent dans ``test/e2e/topologies/frr/``, une par nœud, **écrites à la main** :
|
||||
ce sont les mêmes fichiers que la documentation de déploiement inclut, pour que le lab qualifie
|
||||
exactement ce qu'elle prescrit. Celles des hyperviseurs se réduisent à ``hostname`` et ``log`` :
|
||||
la configuration BGP est posée par l'agent (section ``bgp`` de ``agent.yml``). Celle du route
|
||||
reflector :
|
||||
la configuration BGP est posée par l'agent (section ``bgp`` de ``agent.yml``). Celle du premier
|
||||
route reflector (celle de ``rr2`` ne diffère que par son nom et sa loopback) :
|
||||
|
||||
.. literalinclude:: ../../test/e2e/topologies/frr/rr1.conf
|
||||
:language: text
|
||||
|
|
@ -239,7 +241,7 @@ Les tests se lancent **depuis le Mac**, sur un lab démarré (``up``, ``push``,
|
|||
|
||||
test/e2e/run.sh all # toute la suite, dans l'ordre
|
||||
test/e2e/run.sh 40 # une couche
|
||||
test/e2e/run.sh 41 43 # des tests, par numéro ou par nom
|
||||
test/e2e/run.sh 41 dhcp-two # des tests, par numéro à deux chiffres ou par nom exact
|
||||
test/e2e/run.sh --from 30 # à partir d'un numéro
|
||||
test/e2e/run.sh --continue all # sans s'arrêter sur une couche en échec
|
||||
test/e2e/run.sh --connus all # les échecs connus comptent comme des échecs
|
||||
|
|
@ -408,7 +410,10 @@ tests ont été corrigées sur le serveur et les tests concernés rejoués. Il r
|
|||
(#73, #62), noms des disques SCSI (#74), mode ``bridge`` sur plusieurs hôtes (#75), filtrage au
|
||||
port (#76), socket DHCP (#77), fausse alerte du watchdog (#78) ;
|
||||
* #69 vérifié : au retour de ``sw1`` (priorité 200), il redevient maître, seconde bascule en
|
||||
1,2 s, sessions EVPN jamais coupées ;
|
||||
1,2 s, sessions EVPN jamais coupées. La préemption est pourtant **désactivée** dans la
|
||||
configuration (``no vrrp 1 preempt``, « Preempt Mode No » relevé le 2026-10-23) : la cause de ce
|
||||
retour, après coupure puis rétablissement de l'interface underlay du maître, **n'est pas
|
||||
établie** ;
|
||||
* une suppression de VM peut durer 300 s quand l'invité ignore l'arrêt ACPI (#79) : ``wait_state``
|
||||
attend jusqu'à 360 s.
|
||||
|
||||
|
|
@ -436,18 +441,22 @@ Un test est un fichier ``test/e2e/suite/NN-nom.sh``, exécuté par ``run.sh`` su
|
|||
commence par un en-tête, puis envoie des blocs aux nœuds par ``on <nœud> [VAR=valeur…] <<'NODE'``.
|
||||
Chaque bloc est précédé des bibliothèques de ``test/e2e/lib/`` :
|
||||
|
||||
* ``core.sh`` : ``check``, ``known``, ``info``, appels à l'API, attente des états ;
|
||||
* ``core.sh`` : ``check``, ``known``, ``known_flaky``, ``info``, appels à l'API, attente des états ;
|
||||
* ``vm.sh`` : image Debian compatible two, clé SSH, ``vm_launch`` (plusieurs NIC et disques, UEFI,
|
||||
``user_data``, mot de passe), SSH, bail, métadonnées. La MAC de chaque NIC est fournie à l'API :
|
||||
``52:54:00`` suivi des trois derniers octets de l'IP (``mac_for_ip``), unique dans la suite
|
||||
puisque chaque test a sa plage ; ``--nic sn=ip=mac`` en impose une autre ;
|
||||
* ``net.sh`` : VPC, subnets, MAC anycast, trames brutes, règles ebtables, VRRP ;
|
||||
* ``evpn.sh`` : VRF, BGP, L3VNI, watchdog ;
|
||||
* ``fixture.sh`` : nettoyage et ``assert_clean``, appelés par le runner.
|
||||
* ``fixture.sh`` : nettoyage et ``assert_clean``, appelés par le runner. Le nettoyage couvre les
|
||||
ressources ``t<NN>`` de l'API, les netns ``t<NN>-*`` et les fichiers ``t<NN>-*`` / ``t<NN>.*`` de
|
||||
``/tmp`` et ``/var/tmp/e2e`` (sauf l'état ``t<NN>.avant``) ; il ne joue que pour un test dont
|
||||
l'en-tête « # hôtes: » est rempli. Un test sans aucune vérification propre, hors fixtures, est
|
||||
en échec.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
# fonctionnalité: trafic entre deux VM d'un même subnet sur un hôte
|
||||
# fonctionnalité: trafic entre deux VM d'un même subnet sur un hôte, isolation entre VPC
|
||||
# hôtes: hv1
|
||||
# tickets: #NN
|
||||
|
||||
|
|
@ -459,7 +468,11 @@ Chaque bloc est précédé des bibliothèques de ``test/e2e/lib/`` :
|
|||
check "VM t99-b" vm_launch t99-b --nic sn-t99=10.99.1.11 --sshkey "${KEY}"
|
||||
check "t99-a joignable" vm_wait vp-t99 10.99.1.10
|
||||
check "t99-a joint t99-b" vm_ssh vp-t99 10.99.1.10 'ping -c 2 -W 2 10.99.1.11'
|
||||
check "t99-a ne joint pas 10.98.1.10" vm_fails vp-t99 10.99.1.10 'ping -c 2 -W 2 10.98.1.10'
|
||||
check "VPC vp-t99b" vpc_create vp-t99b 10.99.0.0/16
|
||||
check "subnet sn-t99b" subnet_create sn-t99b vp-t99b 9902 10.99.2.0/24
|
||||
check "VM t99-c" vm_launch t99-c --nic sn-t99b=10.99.2.10 --sshkey "${KEY}"
|
||||
check "t99-c joignable dans son VPC" vm_wait vp-t99b 10.99.2.10
|
||||
check "t99-a ne joint pas t99-c (autre VPC)" vm_fails vp-t99 10.99.1.10 'ping -c 2 -W 2 10.99.2.10'
|
||||
NODE
|
||||
|
||||
Les règles :
|
||||
|
|
|
|||
|
|
@ -48,9 +48,10 @@ Trois règles pour un appelant robuste :
|
|||
borne les opérations qui attendent une transition ; l'appelant doit avoir sa propre borne.
|
||||
* **Traiter ``error`` comme terminal, pas comme un échec transitoire.** Un ``Execute`` en échec
|
||||
ne se rejoue pas tout seul.
|
||||
* **Ne pas enchaîner sans vérifier.** Créer un subnet dont le VPC est encore en ``creating``
|
||||
échoue en 422 ; démarrer une VM sur un subnet en ``creating`` ou ``running`` est en revanche
|
||||
accepté.
|
||||
* **Savoir ce qui s'enchaîne.** Créer un subnet dont le VPC est encore en ``creating``, ou
|
||||
démarrer une VM sur un subnet en ``creating``, est accepté : l'``Execute`` attend que le parent
|
||||
passe ``running``, dans la limite de ``dispatcher.timeout_seconds`` ; au-delà, la ressource passe
|
||||
en ``error``. Le refus en 422 ne vaut que pour un parent absent, en ``error`` ou en ``deleting``.
|
||||
|
||||
Codes de retour
|
||||
---------------
|
||||
|
|
@ -66,15 +67,23 @@ Codes de retour
|
|||
* - ``200``
|
||||
- lecture réussie (``GET``)
|
||||
* - ``400``
|
||||
- champ obligatoire manquant, corps invalide, ``iface_type`` inconnu, base64 invalide
|
||||
- champ obligatoire manquant, corps invalide, base64 invalide ; CIDR de VPC invalide,
|
||||
``l3vni`` hors plage ; ``interface_ip`` absent (``bridge``, ``public_ip``) ou fourni
|
||||
(``vxlan``) ; interface de VM sans ``mac``, nombre d'interfaces ``primary`` différent de 1
|
||||
* - ``404``
|
||||
- ressource inexistante
|
||||
* - ``405``
|
||||
- méthode non prise en charge ; corps ``{"error": "method not allowed"}``, mais servi en
|
||||
``text/plain`` par ``/vpcs`` et ``/subnets`` (et leurs ``/{name}``), en JSON par ``/vms``
|
||||
* - ``409``
|
||||
- conflit d'existence ou d'état : ressource déjà créée, ou suppression depuis un état qui
|
||||
ne l'autorise pas ; pour un VPC, subnets encore présents ; pour un subnet, VM non
|
||||
supprimées qui l'utilisent encore
|
||||
ne l'autorise pas ; pour un VPC, subnets encore présents, ``l3vni`` déjà utilisée par un
|
||||
autre VPC, ou ``l3vni`` demandée sans section ``bgp`` ; pour un subnet, VM non supprimées
|
||||
qui l'utilisent encore
|
||||
* - ``422``
|
||||
- dépendance absente ou pas prête : VPC parent d'un subnet, subnet d'une VM
|
||||
- dépendance absente ou inutilisable : VPC parent d'un subnet, subnet d'une VM, absent, en
|
||||
``error`` ou en ``deleting`` ; ``mode`` de subnet inconnu ; CIDR ``vxlan`` invalide ou plus
|
||||
petit que ``/29`` ; IP de VM hors du CIDR du subnet ou réservée
|
||||
* - ``500``
|
||||
- erreur interne
|
||||
|
||||
|
|
|
|||
|
|
@ -173,7 +173,7 @@ Metadata et QEMU
|
|||
qemu:
|
||||
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
||||
ovmf_vars_template: "/usr/share/OVMF/OVMF_VARS.fd"
|
||||
uefi_vars_dir: "/run/two/vms/efi"
|
||||
uefi_vars_dir: "/run/two/vms/uefi"
|
||||
serial_dir: "/run/two/vms/serial"
|
||||
monitor_dir: "/run/two/vms/monitor"
|
||||
qmp_dir: "/run/two/vms/qmp"
|
||||
|
|
@ -257,6 +257,7 @@ Watchdog
|
|||
interval_seconds: 60
|
||||
|
||||
Vérification périodique **en lecture seule** — voir :doc:`/exploitation/observabilite`.
|
||||
**Désactivée par défaut** (``enabled: false``) : sans cette section, aucun contrôle ne tourne.
|
||||
|
||||
Journalisation
|
||||
--------------
|
||||
|
|
|
|||
|
|
@ -49,7 +49,7 @@ Le DHCP est servi par une instance dédiée au subnet. Quelle unit selon ``dhcp.
|
|||
|
||||
# Ce qu'il enverrait à une MAC donnée, sans effet de bord
|
||||
echo '{"verb":"probe","mac":"00:22:33:00:00:0A"}' \
|
||||
| socat - UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock | jq .lease
|
||||
| socat - UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock | jq '{served, lease}'
|
||||
|
||||
``probe`` est le point de départ le plus rapide : il montre l'adresse, le masque, le routeur, les
|
||||
DNS et les routes classless tels qu'ils partiraient. Une réponse ``"served": false`` signifie que
|
||||
|
|
@ -111,12 +111,14 @@ user-data. Vérification dans le guest :
|
|||
cloud-init query instance-id
|
||||
ls /var/lib/cloud/instances/
|
||||
|
||||
**2. Le serveur de metadata est injoignable.** Depuis le guest :
|
||||
**2. Le serveur de metadata est injoignable.** Depuis le guest — le serveur ne sert que
|
||||
``/meta-data``, ``/user-data``, ``/network-config`` et ``/vendor-data``, tout autre chemin
|
||||
renvoie 404 :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ip route
|
||||
curl -s http://169.254.169.254/latest/meta-data/
|
||||
curl -s http://169.254.169.254/meta-data
|
||||
|
||||
La route ``169.254.169.254/32`` doit être présente, avec l'``interface_ip`` du subnet comme
|
||||
next-hop. Si elle est absente ou pointe ailleurs, la DNAT posée en ``PREROUTING`` dans le netns
|
||||
|
|
@ -133,8 +135,9 @@ Depuis l'host, l'instance correspondante :
|
|||
Le user-data est servi vide
|
||||
---------------------------
|
||||
|
||||
Un document fourni explicitement vide est servi vide — ce n'est pas la même chose qu'un document
|
||||
absent, qui retombe sur le template. Vérifier le contenu réellement écrit :
|
||||
C'est le comportement attendu quand ``user_data`` est absent ou vide à la création : les deux cas
|
||||
sont équivalents, et aucun template ne prend le relais pour ``user-data``. Vérifier le contenu
|
||||
réellement écrit :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
|
|
@ -150,7 +153,7 @@ La VM ne démarre pas (UEFI)
|
|||
.. code-block:: bash
|
||||
|
||||
ls -l /usr/share/OVMF/OVMF_CODE.fd /usr/share/OVMF/OVMF_VARS.fd
|
||||
ls -l /run/two/vms/efi/
|
||||
ls -l /run/two/vms/uefi/
|
||||
|
||||
Sur Debian et Ubuntu, le paquet est ``ovmf``.
|
||||
|
||||
|
|
|
|||
|
|
@ -27,7 +27,8 @@ Watchdog
|
|||
--------
|
||||
|
||||
Une goroutine périodique vérifie que les ressources marquées ``running`` en base existent
|
||||
toujours sur le système, et **notifie les écarts sans jamais réparer**.
|
||||
toujours sur le système, et **notifie les écarts sans jamais réparer**. Il est **désactivé par
|
||||
défaut** (``enabled: false``) ; l'activer explicitement :
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
|
|
@ -72,17 +73,20 @@ Journaux
|
|||
|
||||
journalctl -u agent -f
|
||||
journalctl -u 'metadata@i-web' -n 50
|
||||
tail -f /var/log/dnsmasq-vp-admin_br-sn000001.log # backend dnsmasq
|
||||
journalctl -fu 'dhcp@vp-admin_br-sn000001' # backend two
|
||||
tail -f /var/log/dnsmasq-vp-admin_br-000001.log # backend dnsmasq
|
||||
journalctl -fu 'dhcp@vp-admin_br-000001' # backend two
|
||||
|
||||
Inspection de la base
|
||||
---------------------
|
||||
|
||||
En ligne de commande, sur l'host :
|
||||
En ligne de commande, sur l'host. Le binaire ``db`` n'est **ni publié dans les releases ni
|
||||
déployé** par ``deploy.sh`` : il se compile depuis les sources, puis se copie sur l'host. Sans
|
||||
sous-commande, il n'affiche que son usage ; ``print`` liste toute la base :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
/opt/two/bin/db -conf /etc/two/agent.yml
|
||||
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o db ./cmd/db
|
||||
./db -conf /etc/two/agent.yml print
|
||||
|
||||
.. warning::
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,8 @@
|
|||
Services systemd
|
||||
================
|
||||
|
||||
Quatre units, installées sous ``/opt/two/bin`` par ``deploy.sh``. Les deux units DHCP
|
||||
Quatre units, installées dans ``/etc/systemd/system`` par ``deploy.sh`` ; les binaires et scripts
|
||||
qu'elles lancent sont sous ``/opt/two/bin``. Les deux units DHCP
|
||||
s'excluent : celle qui tourne dépend de ``dhcp.backend`` (voir :doc:`configuration`).
|
||||
|
||||
.. list-table::
|
||||
|
|
@ -30,8 +31,8 @@ n'y a pas à les démarrer à la main en fonctionnement normal.
|
|||
.. code-block:: bash
|
||||
|
||||
systemctl status agent
|
||||
systemctl status 'dnsmasq@vp-admin_br-sn000001' # backend dnsmasq
|
||||
systemctl status 'dhcp@vp-admin_br-sn000001' # backend two
|
||||
systemctl status 'dnsmasq@vp-admin_br-000001' # backend dnsmasq
|
||||
systemctl status 'dhcp@vp-admin_br-000001' # backend two
|
||||
systemctl status 'metadata@i-web'
|
||||
|
||||
dnsmasq
|
||||
|
|
@ -65,9 +66,9 @@ ignore le netns dans lequel il tourne :
|
|||
.. code-block:: bash
|
||||
|
||||
/opt/two/bin/dhcp -conf /etc/two/agent.yml \
|
||||
-interface br-sn000001 \
|
||||
-state /run/two/dhcp/vp-admin_br-sn000001.state \
|
||||
-socket /run/two/dhcp/vp-admin_br-sn000001.sock
|
||||
-interface br-000001 \
|
||||
-state /run/two/dhcp/vp-admin_br-000001.state \
|
||||
-socket /run/two/dhcp/vp-admin_br-000001.sock
|
||||
|
||||
.. list-table::
|
||||
:widths: 40 60
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
|
||||
|
|
@ -50,7 +50,7 @@
|
|||
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
|
||||
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
|
||||
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">au moins un, deux prévus · AS 64600 face aux hyperviseurs (local-as)</text>
|
||||
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
|
||||
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
|
||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
|
||||
|
|
@ -74,9 +74,11 @@
|
|||
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="150" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -88,8 +90,8 @@
|
|||
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
@ -120,9 +122,11 @@
|
|||
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="730" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -134,8 +138,8 @@
|
|||
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 900" width="1200" height="900" role="img" aria-label="Détail d'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
|
||||
|
|
@ -50,7 +50,7 @@
|
|||
<text class="lbl" x="1020.0" y="77.0" text-anchor="middle">route reflector 2</text>
|
||||
<text class="sub" x="1020.0" y="94.0" text-anchor="middle">lo 10.255.255.2/32 · 169.254.0.4/28</text>
|
||||
<text class="sub" x="890" y="132" text-anchor="middle">router-id, cluster-id et source des sessions EVPN : la loopback</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">un par cluster (vue d'ensemble) ; le lab les réunit dans un seul</text>
|
||||
<text class="sub" x="890" y="148" text-anchor="middle">au moins un, deux prévus · AS 64600 face aux hyperviseurs (local-as)</text>
|
||||
<path class="ctrl" d="M480 80 H640" marker-start="url(#a-ctrl)" marker-end="url(#a-ctrl)"/>
|
||||
<text class="ctrlt" x="560" y="72" text-anchor="middle">eBGP · BFD</text>
|
||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</text>
|
||||
|
|
@ -74,9 +74,11 @@
|
|||
<rect class="box" x="60" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="150.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="150.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="150.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="150.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="150.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="150" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -88,8 +90,8 @@
|
|||
<text class="sub" x="482.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="482.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="285" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="415.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="415.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="285" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="415.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="415.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
@ -120,9 +122,11 @@
|
|||
<rect class="box" x="640" y="430" width="180" height="52" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="453.0" text-anchor="middle">agent</text>
|
||||
<text class="sub" x="730.0" y="470.0" text-anchor="middle">API REST · Badger</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="56" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
||||
<text class="sub" x="730.0" y="552.0" text-anchor="middle">dans br-<subnet>, sans learning</text>
|
||||
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||
<text class="lbl" x="730.0" y="532.0" text-anchor="middle">br-<subnet> de l'hôte</text>
|
||||
<text class="sub" x="730.0" y="549.0" text-anchor="middle">vxlan-<vni>, sans learning</text>
|
||||
<text class="sub" x="730.0" y="564.0" text-anchor="middle">veth v-<id>-e</text>
|
||||
<text class="sub" x="730" y="596" text-anchor="middle">veth v-<id>-e ↔ v-<id>-i</text>
|
||||
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
||||
|
|
@ -134,8 +138,8 @@
|
|||
<text class="sub" x="1062.5" y="351.0" text-anchor="middle">métadonnées</text>
|
||||
<text class="sub" x="1062.5" y="366.0" text-anchor="middle">écoutent sur gw-</text>
|
||||
<rect class="box" x="865" y="400" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet></text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253</text>
|
||||
<text class="lbl" x="995.0" y="423.0" text-anchor="middle">br-<subnet> du netns</text>
|
||||
<text class="sub" x="995.0" y="440.0" text-anchor="middle">adresse d'émission .253 · v-<id>-i</text>
|
||||
<rect class="box" x="865" y="478" width="260" height="52" rx="6"/>
|
||||
<text class="lbl" x="995.0" y="501.0" text-anchor="middle">VM</text>
|
||||
<text class="sub" x="995.0" y="518.0" text-anchor="middle">QEMU / KVM · tap dans le netns</text>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #9198a1; }
|
||||
|
|
@ -47,8 +47,8 @@
|
|||
<rect class="future" x="1200" y="50" width="240" height="52" rx="6"/>
|
||||
<text class="lbl" x="1320.0" y="73.0" text-anchor="middle">Terraform / OpenTofu</text>
|
||||
<text class="sub" x="1320.0" y="90.0" text-anchor="middle">provider two · #72</text>
|
||||
<text class="nett" x="1164" y="150" text-anchor="end">API publique de l'orchestrateur</text>
|
||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
||||
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1040" y="56" text-anchor="middle">API publique de l'orchestrateur</text>
|
||||
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
||||
|
|
@ -173,7 +173,9 @@
|
|||
<path class="link" d="M300 635 V460"/>
|
||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
||||
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
|
||||
<path class="net" d="M1180 76 H1172 V546 H1160" marker-end="url(#a-net)"/>
|
||||
<path class="net" d="M750 240 V300 H1140 V520" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1132" y="430" text-anchor="end">API publique</text>
|
||||
<text class="nett" x="1132" y="446" text-anchor="end">VNI 66001</text>
|
||||
<path class="data" d="M60 1045 H110"/>
|
||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||
<path class="ctrl" d="M290 1045 H340"/>
|
||||
|
|
@ -184,10 +186,10 @@
|
|||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
||||
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
|
||||
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les traduisent (NAT) vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
|
||||
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans son VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
|
||||
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de son VPC (IP de sortie du VPC) si le VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
|
||||
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Au moins un route reflector ; deux prévus, ici un par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
</svg>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
|
@ -1,4 +1,4 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 1210" width="1500" height="1210" role="img" aria-label="Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs">
|
||||
<style>
|
||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
||||
.sub { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 11px; fill: #57606a; }
|
||||
|
|
@ -47,8 +47,8 @@
|
|||
<rect class="future" x="1200" y="50" width="240" height="52" rx="6"/>
|
||||
<text class="lbl" x="1320.0" y="73.0" text-anchor="middle">Terraform / OpenTofu</text>
|
||||
<text class="sub" x="1320.0" y="90.0" text-anchor="middle">provider two · #72</text>
|
||||
<text class="nett" x="1164" y="150" text-anchor="end">API publique de l'orchestrateur</text>
|
||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
||||
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1040" y="56" text-anchor="middle">API publique de l'orchestrateur</text>
|
||||
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
||||
|
|
@ -173,7 +173,9 @@
|
|||
<path class="link" d="M300 635 V460"/>
|
||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
||||
<text class="orcht" x="340" y="596" text-anchor="start">register · ordres · événements (mTLS, sortant)</text>
|
||||
<path class="net" d="M1180 76 H1172 V546 H1160" marker-end="url(#a-net)"/>
|
||||
<path class="net" d="M750 240 V300 H1140 V520" marker-end="url(#a-net)"/>
|
||||
<text class="nett" x="1132" y="430" text-anchor="end">API publique</text>
|
||||
<text class="nett" x="1132" y="446" text-anchor="end">VNI 66001</text>
|
||||
<path class="data" d="M60 1045 H110"/>
|
||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||
<path class="ctrl" d="M290 1045 H340"/>
|
||||
|
|
@ -184,10 +186,10 @@
|
|||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
||||
<rect class="future" x="880" y="1035" width="34" height="20" rx="4"/>
|
||||
<text class="sub" x="922" y="1049" text-anchor="start">à venir (ticket indiqué)</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1089" text-anchor="start">Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les traduisent (NAT) vers le VNI 66000.</text>
|
||||
<text class="sub" x="60" y="1107" text-anchor="start">L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.</text>
|
||||
<text class="sub" x="60" y="1125" text-anchor="start">VM publique : un subnet public dans son VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.</text>
|
||||
<text class="sub" x="60" y="1143" text-anchor="start">VM privée : route par défaut de type 5 vers la passerelle NAT de son VPC (IP de sortie du VPC) si le VPC autorise Internet, ou IP flottante 1:1 sur son hôte.</text>
|
||||
<text class="sub" x="60" y="1161" text-anchor="start">Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
<text class="sub" x="60" y="1179" text-anchor="start">Au moins un route reflector ; deux prévus, ici un par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.</text>
|
||||
</svg>
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
|
|
@ -15,12 +15,13 @@ def hv(x0, name):
|
|||
g.box(x0 + 20, 280, 180, 52, "br-000000", ["IP de l'hyperviseur = VTEP"])
|
||||
g.box(x0 + 20, 350, 180, 62, "FRR", ["bgpd · AS 64600", "advertise-all-vni"])
|
||||
g.box(x0 + 20, 430, 180, 52, "agent", ["API REST · Badger"])
|
||||
g.box(x0 + 20, 510, 180, 56, "vxlan-<vni>", ["dans br-<subnet>, sans learning"])
|
||||
g.box(x0 + 20, 510, 180, 66, "br-<subnet> de l'hôte", ["vxlan-<vni>, sans learning", "veth v-<id>-e"])
|
||||
g.text(x0 + 110, 596, "veth v-<id>-e ↔ v-<id>-i", "sub", "middle")
|
||||
|
||||
g.group(x0 + 230, 280, 290, 300, "NETNS DU VPC")
|
||||
g.box(x0 + 245, 312, 125, 66, "gw-<subnet>", ["gateway .254", "MAC anycast"])
|
||||
g.box(x0 + 380, 312, 125, 66, "DHCP", ["métadonnées", "écoutent sur gw-"])
|
||||
g.box(x0 + 245, 400, 260, 52, "br-<subnet>", ["adresse d'émission .253"])
|
||||
g.box(x0 + 245, 400, 260, 52, "br-<subnet> du netns", ["adresse d'émission .253 · v-<id>-i"])
|
||||
g.box(x0 + 245, 478, 260, 52, "VM", ["QEMU / KVM · tap dans le netns"])
|
||||
g.text(x0 + 375, 552, "macvlan gw- posé sur br-, confiné à l'hôte (#57)", "sub", "middle")
|
||||
g.box(x0 + 230, 610, 290, 62, "vrf-<vpc> · L3VNI", ["brl3 · vxl3 · veth de transit", "routage entre hyperviseurs (#41)"])
|
||||
|
|
@ -48,7 +49,7 @@ def draw():
|
|||
g.box(640, 52, 240, 56, "route reflector 1", ["lo 10.255.255.1/32 · 169.254.0.3/28"])
|
||||
g.box(900, 52, 240, 56, "route reflector 2", ["lo 10.255.255.2/32 · 169.254.0.4/28"])
|
||||
g.text(890, 132, "router-id, cluster-id et source des sessions EVPN : la loopback", "sub", "middle")
|
||||
g.text(890, 148, "un par cluster (vue d'ensemble) ; le lab les réunit dans un seul", "sub", "middle")
|
||||
g.text(890, 148, "au moins un, deux prévus · AS 64600 face aux hyperviseurs (local-as)", "sub", "middle")
|
||||
|
||||
g.path("M480 80 H640", "ctrl", start=True, end=True)
|
||||
g.text(560, 72, "eBGP · BFD", "ctrlt", "middle")
|
||||
|
|
@ -91,7 +92,7 @@ def draw():
|
|||
def render(p):
|
||||
g.out.clear()
|
||||
draw()
|
||||
head = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" width="{W}" height="{H}" role="img" aria-label="Architecture du cluster : routeurs, route reflectors, hyperviseurs, plans de données et de contrôle">'
|
||||
head = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" width="{W}" height="{H}" role="img" aria-label="Détail d\'un cluster : routeurs, route reflectors, hyperviseurs, netns et VRF des VPC, plans de données et de contrôle">'
|
||||
st = g.style(p).replace(" </style>", made_style(p) + " </style>").replace(
|
||||
" </defs>",
|
||||
' <marker id="a-made" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path class="head-made" d="M0 0 L10 5 L0 10 z"/></marker>\n </defs>')
|
||||
|
|
|
|||
|
|
@ -78,7 +78,6 @@ def path(d, cls, start=False, end=False):
|
|||
def draw():
|
||||
dy = 205
|
||||
|
||||
# Internet et bordures
|
||||
out.append(' <rect class="pill" x="600" y="20" width="300" height="56" rx="28"/>')
|
||||
text(750, 54, "Internet", "lbl", "middle")
|
||||
path("M750 76 V110", "net", start=True, end=True)
|
||||
|
|
@ -89,19 +88,16 @@ def draw():
|
|||
text(750, 214, "même IP et même MAC de gateway · sans état", "sub", "middle")
|
||||
text(750, 230, "VTEP · VNI 66001 (public)", "sub", "middle")
|
||||
|
||||
# Poste de l'opérateur
|
||||
group(1180, 20, 280, 100, "POSTE DE L'OPÉRATEUR")
|
||||
box(1200, 50, 240, 52, "Terraform / OpenTofu", ["provider two · #72"], "future")
|
||||
text(1164, 150, "API publique de l'orchestrateur", "nett", "end")
|
||||
text(1164, 166, "par Internet et les bordures (VNI 66001)", "nett", "end")
|
||||
path("M1180 64 H900", "net", end=True)
|
||||
text(1040, 56, "API publique de l'orchestrateur", "nett", "middle")
|
||||
|
||||
# Underlay A : routeurs
|
||||
group(40, 280, 480, 130, "CLUSTER A")
|
||||
box(60, 312, 210, 56, "routeur 1", ["169.254.0.1/28"])
|
||||
box(290, 312, 210, 56, "routeur 2", ["169.254.0.2/28"])
|
||||
text(280, 392, "VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72", "sub", "middle")
|
||||
|
||||
# Underlay B
|
||||
group(1200, 280, 260, 130, "CLUSTER B")
|
||||
box(1215, 312, 110, 56, "routeur 1", ["169.254.0.1/28"])
|
||||
box(1335, 312, 110, 56, "routeur 2", ["169.254.0.2/28"])
|
||||
|
|
@ -122,7 +118,6 @@ def draw():
|
|||
text(1330, 765 + dy, "l'hyperviseur détaillé", "sub", "middle")
|
||||
path(f"M1452 460 V{395 + dy}", "link")
|
||||
|
||||
# eBGP
|
||||
path("M500 340 H1215", "link")
|
||||
text(860, 332, "eBGP · routeur 2 de A → routeur 1 de B", "sub", "middle")
|
||||
path("M660 240 V258 H210 V312", "link")
|
||||
|
|
@ -130,7 +125,6 @@ def draw():
|
|||
text(420, 252, "eBGP", "sub", "middle")
|
||||
text(1060, 252, "eBGP", "sub", "middle")
|
||||
|
||||
# Underlay A : bus, route reflector, services
|
||||
out.append(' <line class="bus" x1="40" y1="460" x2="680" y2="460"/>')
|
||||
text(690, 465, "underlay A · VXLAN UDP 4789 · BGP", "sub")
|
||||
path("M75 368 V460", "link")
|
||||
|
|
@ -145,7 +139,6 @@ def draw():
|
|||
path("M510 410 V546 H760", "orch", end=True)
|
||||
path("M1200 400 H1192 V560 H1180", "orch", end=True)
|
||||
|
||||
# Hyperviseur
|
||||
group(40, 395 + dy, 1120, 410, "HYPERVISEUR A (détaillé)")
|
||||
box(60, 430 + dy, 260, 52, "br-000000", ["IP de l'hyperviseur = VTEP"])
|
||||
box(60, 496 + dy, 260, 52, "FRR · bgpd", ["sessions EVPN vers les RR"])
|
||||
|
|
@ -174,13 +167,13 @@ def draw():
|
|||
out.append(f' <text class="datat" x="30" y="{600 + dy}" text-anchor="middle" transform="rotate(-90 30 {600 + dy})">VNI 66001</text>')
|
||||
path(f"M300 {430 + dy} V460", "link")
|
||||
|
||||
# Orchestration : agent → routeurs de l'underlay A
|
||||
path(f"M320 {580 + dy} H332 V410", "orch", end=True)
|
||||
text(340, 596, "register · ordres · événements (mTLS, sortant)", "orcht")
|
||||
|
||||
path("M1180 76 H1172 V546 H1160", "net", end=True)
|
||||
path("M750 240 V300 H1140 V520", "net", end=True)
|
||||
text(1132, 430, "API publique", "nett", "end")
|
||||
text(1132, 446, "VNI 66001", "nett", "end")
|
||||
|
||||
# Légende
|
||||
ly = 840 + dy
|
||||
path(f"M60 {ly} H110", "data")
|
||||
text(118, ly + 4, "plan de données : VXLAN")
|
||||
|
|
@ -194,12 +187,12 @@ def draw():
|
|||
text(922, ly + 4, "à venir (ticket indiqué)")
|
||||
|
||||
notes = [
|
||||
"Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000.",
|
||||
"Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les traduisent (NAT) vers le VNI 66000.",
|
||||
"L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures.",
|
||||
"VM publique : un subnet public dans son VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures.",
|
||||
"VM privée : route par défaut de type 5 vers la passerelle NAT de son VPC (IP de sortie du VPC) si le VPC autorise Internet, ou IP flottante 1:1 sur son hôte.",
|
||||
"Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster.",
|
||||
"Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.",
|
||||
"Au moins un route reflector ; deux prévus, ici un par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster.",
|
||||
]
|
||||
for k, n in enumerate(notes):
|
||||
text(60, 884 + dy + k * 18, n)
|
||||
|
|
@ -208,7 +201,7 @@ def draw():
|
|||
def render(p):
|
||||
out.clear()
|
||||
draw()
|
||||
head = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" width="{W}" height="{H}" role="img" aria-label="Vue d\'ensemble : Internet, bordures, routeurs du cluster, services, orchestration et hyperviseurs">'
|
||||
head = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W} {H}" width="{W}" height="{H}" role="img" aria-label="Vue d\'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs">'
|
||||
return "\n".join([head, style(p)] + out + ["</svg>", ""])
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -136,6 +136,9 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
|
|||
- **Un fichier de configuration présent mais invalide fait désormais échouer le démarrage.**
|
||||
Jusqu'en 0.1.0 l'erreur de lecture était ignorée : l'agent tournait alors entièrement sur ses
|
||||
valeurs par défaut sans le dire, ce qui rendait indétectable une simple tabulation d'indentation
|
||||
- **Réponses de l'API des subnets alignées sur la spécification** : `gateway` est rendu aussi par
|
||||
`GET /subnets` et par la réponse 202 de `POST /subnets`, plus seulement par
|
||||
`GET /subnets/{name}` ; `vxlan_id` est omis hors mode `vxlan` au lieu de valoir 0 (#80)
|
||||
- `probe` annonce explicitement `"served": false` pour une MAC non réservée, au lieu d'omettre le
|
||||
champ et de le rendre indistinguable d'une réponse tronquée
|
||||
- **Le serveur DHCP intégré s'arrête proprement** sur `SIGTERM` et `SIGINT` : il ferme sa socket de
|
||||
|
|
|
|||