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 |
|
| Option | Effet |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `-t <tag>` | déployer une release donnée |
|
| `-t <tag>` | déployer une release donnée ; sans `-t`, la dernière publiée, préversions comprises |
|
||||||
| `-b <branche>` | déployer depuis une branche au lieu d'une release |
|
| `-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) |
|
| `-i` | préparer l'host (paquets, noyau, réseau) |
|
||||||
| `-u <iface>` | interface physique d'uplink, `eno1` par défaut |
|
| `-u <iface>` | interface physique d'uplink, `eno1` par défaut |
|
||||||
| `-B <bridge>` | bridge principal auquel l'uplink est rattaché |
|
| `-B <bridge>` | bridge principal auquel l'uplink est rattaché |
|
||||||
| `-d` | dry-run : affiche les commandes sans les exécuter |
|
| `-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
|
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.
|
services, et les redémarre ensuite — c'est la seule façon de savoir lesquelles relancer.
|
||||||
|
|
||||||
## Configuration
|
## 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 :
|
[`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
|
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.
|
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
|
# Un subnet en VXLAN dans ce VPC
|
||||||
curl -X POST http://127.0.0.1:8080/subnets \
|
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"}'
|
"iface_type": "vms", "cidr": "10.1.0.0/23"}'
|
||||||
|
|
||||||
# Une VM, avec une clé SSH et un user-data cloud-init en base64
|
# 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…",
|
"metadata": {"sshkey": "ssh-ed25519 AAAA…",
|
||||||
"user_data": "'"$(base64 -w0 < user-data.yml)"'"},
|
"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}],
|
"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
|
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 |
|
| `agent` | processus principal : API, dispatcher, exécution, watchdog |
|
||||||
| `metadata` | serveur de metadata cloud-init, une instance par VM dans le netns du VPC |
|
| `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
|
## Versions
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -76,7 +76,7 @@ qemu:
|
||||||
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
||||||
ovmf_vars_template: "/usr/share/OVMF/OVMF_VARS.fd"
|
ovmf_vars_template: "/usr/share/OVMF/OVMF_VARS.fd"
|
||||||
# Per-VM UEFI variable store (writable copy, created at start / deleted at stop)
|
# 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
|
# QEMU Unix socket directories
|
||||||
serial_dir: "/run/two/vms/serial"
|
serial_dir: "/run/two/vms/serial"
|
||||||
monitor_dir: "/run/two/vms/monitor"
|
monitor_dir: "/run/two/vms/monitor"
|
||||||
|
|
|
||||||
|
|
@ -11,10 +11,10 @@ pip install -r requirements.txt
|
||||||
sphinx-autobuild . "${TMPDIR}/build"
|
sphinx-autobuild . "${TMPDIR}/build"
|
||||||
```
|
```
|
||||||
|
|
||||||
Construction simple :
|
Construction simple, avec les mêmes options que la CI (avertissements bloquants) :
|
||||||
|
|
||||||
```bash
|
```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
|
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
|
Contraintes découvertes en production ou en corrigeant des bugs. Les enfreindre casse quelque
|
||||||
chose qui fonctionne, souvent en silence.
|
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
|
Réseau
|
||||||
------
|
------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -2,8 +2,7 @@ Architecture
|
||||||
============
|
============
|
||||||
|
|
||||||
L'organisation interne de l'agent : découpage en paquets, stockage, et contraintes à ne pas
|
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,
|
enfreindre. Ces pages s'adressent à qui modifie le code.
|
||||||
reste la référence de développement et fait foi en cas d'écart.
|
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
|
||||||
|
|
@ -58,16 +58,28 @@ Paquets
|
||||||
- cycle de vie d'une VM : tap, iptables, metadata, qemu
|
- cycle de vie d'une VM : tap, iptables, metadata, qemu
|
||||||
* - ``internal/dhcp``
|
* - ``internal/dhcp``
|
||||||
- plan d'adressage ip → mac, et configurations dnsmasq du backend historique
|
- 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``
|
* - ``internal/metadata``
|
||||||
- serveur de metadata cloud-init et ses templates
|
- serveur de metadata cloud-init et ses templates
|
||||||
* - ``internal/watchdog``
|
* - ``internal/watchdog``
|
||||||
- vérification périodique en lecture seule
|
- vérification périodique en lecture seule
|
||||||
|
* - ``internal/watchdog/notify``
|
||||||
|
- émission des écarts relevés par le watchdog (journal)
|
||||||
* - ``internal/config/agent``
|
* - ``internal/config/agent``
|
||||||
- chargement par viper — tags ``mapstructure``, jamais ``yaml``
|
- chargement par viper — tags ``mapstructure``, jamais ``yaml``
|
||||||
* - ``internal/prometheus/agent``
|
* - ``internal/prometheus/agent``
|
||||||
- collector des métriques ``syonad_*``
|
- collector des métriques ``syonad_*``
|
||||||
* - ``pkg/db/kv``
|
* - ``pkg/db/kv``
|
||||||
- wrapper Badger ; toutes les valeurs sont des chaînes plates
|
- 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``
|
* - ``pkg/worker``
|
||||||
- pool de goroutines sur canal
|
- pool de goroutines sur canal
|
||||||
* - ``pkg/systemd``
|
* - ``pkg/systemd``
|
||||||
|
|
|
||||||
|
|
@ -10,7 +10,6 @@ VPC, subnets et VM partagent le même jeu d'états.
|
||||||
creating --> running
|
creating --> running
|
||||||
creating --> error
|
creating --> error
|
||||||
running --> deleting
|
running --> deleting
|
||||||
running --> error
|
|
||||||
deleting --> deleted
|
deleting --> deleted
|
||||||
deleting --> error
|
deleting --> error
|
||||||
error --> deleting
|
error --> deleting
|
||||||
|
|
@ -27,7 +26,9 @@ VPC, subnets et VM partagent le même jeu d'états.
|
||||||
* - ``running``
|
* - ``running``
|
||||||
- la ressource existe sur le système
|
- la ressource existe sur le système
|
||||||
* - ``error``
|
* - ``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``
|
* - ``deleting``
|
||||||
- suppression en cours
|
- suppression en cours
|
||||||
* - ``deleted``
|
* - ``deleted``
|
||||||
|
|
|
||||||
|
|
@ -20,14 +20,14 @@ deux processus ne doivent pas partager une même instance.
|
||||||
Documents servis
|
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 ;
|
* ``user_data`` fourni → servi **verbatim**, après décodage base64 ; l'agent n'interprète rien ;
|
||||||
* absent → le template par défaut est rendu ;
|
* ``user_data`` absent ou **vide** → ``user-data`` servi vide : les deux cas sont équivalents.
|
||||||
* fourni **vide** → servi vide.
|
|
||||||
|
|
||||||
Les deux derniers cas sont distincts, et c'est délibéré : fournir une chaîne vide est une façon
|
``meta-data``, ``network-config`` et ``vendor-data`` sont **toujours** rendus depuis les templates
|
||||||
explicite de neutraliser un document.
|
de l'agent ; ``vendor-data`` crée le compte ``syonad`` à partir de ``password`` et ``sshkey``.
|
||||||
|
|
||||||
Champs de ``metadata``
|
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,
|
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 ``/32`` vers ``169.254.169.254``, le serveur de metadata ;
|
||||||
#. la route vers le CIDR du VPC ;
|
#. la route vers le CIDR du VPC, **sauf en mode** ``bridge`` ;
|
||||||
#. la route par défaut ``0.0.0.0/0``.
|
#. 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::
|
.. important::
|
||||||
|
|
||||||
|
|
@ -163,8 +164,8 @@ RFC 3442). Trois entrées y figurent :
|
||||||
Route par défaut : ``default_route`` et ``gateway``
|
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
|
Une route par défaut est **toujours** annoncée à l'interface ``primary`` d'une VM, et à elle
|
||||||
next-hop :
|
seule. Le champ ``default_route`` ne choisit que son next-hop :
|
||||||
|
|
||||||
``default_route: false`` (défaut)
|
``default_route: false`` (défaut)
|
||||||
next-hop = ``interface_ip`` du subnet, la gateway calculée en ``vxlan``.
|
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
|
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
|
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
|
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é
|
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.
|
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.
|
Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.
|
||||||
|
|
||||||
Routage entre hyperviseurs : ``l3vni``
|
Routage entre hyperviseurs : ``l3vni``
|
||||||
|
|
@ -112,6 +118,9 @@ depuis le subnet, leur source canonique. Le schéma complet des clés est dans
|
||||||
Nommage
|
Nommage
|
||||||
-------
|
-------
|
||||||
|
|
||||||
L'API est machine-to-machine : elle **ne valide pas** les conventions de nommage, à l'exception
|
L'API est machine-to-machine : elle **ne valide aucun nommage**, pas même le motif ``vp-…``
|
||||||
du motif documenté pour les VPC (``vp-…``). Les exemples de cette documentation suivent la
|
indiqué par la spécification pour les VPC. Une contrainte est pourtant réelle : le nom d'un VPC
|
||||||
convention ``vp-`` / ``sn-`` / ``i-``, mais c'est à l'appelant de la faire respecter.
|
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
|
- Défaut
|
||||||
* - ``-t <tag>``
|
* - ``-t <tag>``
|
||||||
- déployer une release donnée
|
- déployer une release donnée
|
||||||
- dernière
|
- dernière publiée, **préversions comprises**
|
||||||
* - ``-b <branche>``
|
* - ``-b <branche>/``
|
||||||
- branche utilisée pour l'auto-mise à jour du script
|
- branche d'où viennent l'auto-mise à jour du script et les scripts de ``-i`` ; les
|
||||||
- ``main``
|
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>``
|
* - ``-p <profil>``
|
||||||
- profil d'host ; seul ``kvm`` installe les units de l'agent
|
- profil d'host ; seul ``kvm`` installe les units de l'agent
|
||||||
- ``kvm``
|
- ``kvm``
|
||||||
|
|
@ -48,7 +50,8 @@ depuis la release, et les vérifie contre le manifeste ``SHA256SUMS``.
|
||||||
- bridge principal, auquel l'uplink est rattaché
|
- bridge principal, auquel l'uplink est rattaché
|
||||||
- ``br-000000``
|
- ``br-000000``
|
||||||
* - ``-P <bridge>``
|
* - ``-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``
|
- ``br-public``
|
||||||
* - ``-R <secondes>``
|
* - ``-R <secondes>``
|
||||||
- délai avant le redémarrage de secours pendant la migration réseau
|
- 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,
|
**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.
|
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::
|
.. danger::
|
||||||
|
|
||||||
La migration réseau **coupe le réseau de l'host si elle échoue à mi-parcours**, sans console
|
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
|
- serveur de metadata cloud-init, une instance par VM dans le netns du VPC
|
||||||
- ``-conf``
|
- ``-conf``
|
||||||
* - ``db``
|
* - ``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``
|
- ``-conf``
|
||||||
* - ``dhcp``
|
* - ``dhcp``
|
||||||
- serveur DHCP intégré, une instance par subnet dans le netns du VPC ; démarré uniquement
|
- serveur DHCP intégré, une instance par subnet dans le netns du VPC ; démarré uniquement
|
||||||
avec ``dhcp.backend: two``
|
avec ``dhcp.backend: two``
|
||||||
- ``-conf``
|
- ``-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
|
: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.
|
fichiers en paramètres, posés par son script d'enrobage.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -14,16 +14,19 @@ Ce que l'on construit
|
||||||
|
|
||||||
graph LR
|
graph LR
|
||||||
subgraph netns vp-admin
|
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"]
|
MD["metadata@i-web<br/>169.254.169.254"]
|
||||||
end
|
end
|
||||||
VM["VM i-web<br/>10.1.1.2"] --- BR
|
VM["VM i-web<br/>10.1.1.2"] --- BR
|
||||||
BR --- MD
|
BR --- GW
|
||||||
BR --- VXLAN["VXLAN vni 1<br/>br-000000"]
|
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
|
Le VPC est un network namespace ; le subnet y pose un bridge ``br-000001`` — ``br-`` suivi de ce
|
||||||
raccroche par un tap, reçoit son adresse en DHCP et son cloud-init depuis le serveur de metadata
|
qui suit le premier tiret du nom du subnet — porteur de l'adresse d'émission, et un macvlan
|
||||||
du netns.
|
``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
|
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
|
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
|
Un subnet peut être demandé dès maintenant : il est accepté tant que le VPC est en ``creating``
|
||||||
prêt est refusé en **422**. Le modèle d'attente est décrit dans :doc:`/exploitation/api-agent/asynchronisme`.
|
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
|
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",
|
-d '{"name": "sn-000001",
|
||||||
"vpc": "vp-admin",
|
"vpc": "vp-admin",
|
||||||
"mode": "vxlan",
|
"mode": "vxlan",
|
||||||
"vxlan_id": 1,
|
"vxlan_id": 65537,
|
||||||
"iface_type": "vms",
|
"iface_type": "vms",
|
||||||
"cidr": "10.1.0.0/23"}'
|
"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
|
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
|
.. code-block:: bash
|
||||||
|
|
||||||
ssh syonad@10.1.1.2
|
ip netns exec vp-admin ssh syonad@10.1.1.2
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
En mode ``vxlan``, la VM vit dans le netns du VPC : elle n'est pas joignable depuis l'host
|
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
|
5. Supprimer
|
||||||
------------
|
------------
|
||||||
|
|
|
||||||
|
|
@ -24,9 +24,9 @@ Vue d'ensemble
|
||||||
(BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés :
|
(BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés :
|
||||||
élément à venir, avec son ticket.
|
élément à venir, avec son ticket.
|
||||||
|
|
||||||
Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés
|
Plusieurs clusters, chacun avec son underlay et ses deux routeurs, sont reliés en eBGP entre eux
|
||||||
en eBGP entre eux et aux **routeurs de bordure**. Ce qui n'existe pas encore est décrit sur son
|
et aux **routeurs de bordure** ; les route reflectors sont décrits plus bas. Ce qui n'existe pas
|
||||||
ticket :
|
encore est décrit sur son ticket :
|
||||||
|
|
||||||
* **Internet** (`#31 <https://git.g3e.fr/syonad/two/issues/31>`_,
|
* **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
|
`#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
|
* **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
|
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.
|
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
|
* **Route reflectors.** Au moins un ; deux sont prévus dans l'architecture et dans les exemples
|
||||||
sessions EVPN. Chaque lien entre routeurs et route reflector est en ``169.254.0.0/28``, propre
|
(plages d'adresses de :doc:`route-reflector`), placés ici dans deux clusters différents pour
|
||||||
à son cluster.
|
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
|
Le lab (:doc:`/developpement/lab`) simplifie : un seul cluster, qui porte les deux route
|
||||||
reflectors.
|
reflectors.
|
||||||
|
|
@ -79,7 +86,7 @@ Plan de données
|
||||||
|
|
||||||
Plan de contrôle
|
Plan de contrôle
|
||||||
ce qui dit à chaque hyperviseur où se trouvent les adresses MAC des autres. C'est le rôle de
|
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
|
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
|
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.
|
le deuxième nœud.
|
||||||
|
|
||||||
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et le route reflector qui
|
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et les route reflectors qui
|
||||||
les fait converger.
|
les font converger.
|
||||||
|
|
||||||
MTU
|
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
|
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
|
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.
|
fonctionne.
|
||||||
|
|
||||||
Étapes
|
É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
|
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
|
``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
|
``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 :
|
Ce qu'elle établit :
|
||||||
|
|
||||||
* **Une session par route reflector**, en iBGP dans l'AS 64600, vers sa loopback
|
* **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
|
(``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.
|
un nœud ne touche pas la configuration des autres.
|
||||||
* **EVPN seulement** : l'IPv4 unicast n'est pas activé (``no bgp default ipv4-unicast``).
|
* **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
|
``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
|
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
|
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.
|
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``
|
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>`_) : l'adresse IPv4 primaire du ``local_iface``
|
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_, fermé) : l'adresse IPv4 primaire du
|
||||||
du subnet.
|
``local_iface`` du subnet.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|
@ -93,11 +93,10 @@ du subnet.
|
||||||
et configuration doivent être posés à chaque démarrage, par le bootstrap ou un mécanisme
|
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>`_) ;
|
é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 ;
|
* 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
|
* les subnets ``vxlan`` créés par une version antérieure, dont la VXLAN n'a pas d'adresse VTEP
|
||||||
locale : les recréer ou poser l'adresse à chaud, à trancher dans
|
locale : aucune migration ne la pose, il faut les recréer ;
|
||||||
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_ ;
|
|
||||||
* le cas particulier du **premier** hyperviseur, dont la session ne peut pas s'établir tant
|
* 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
|
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
|
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
|
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
|
reflector, qui redistribue. Un cluster en compte **au moins un** ; l'architecture et les exemples
|
||||||
adresses : chaque hyperviseur ouvre une session vers chacun, et la perte de l'un ne doit pas
|
de cette page en prévoient **deux** (rr1 et rr2, d'où les plages d'adresses ci-dessous),
|
||||||
interrompre le plan de contrôle (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_).
|
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
|
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.
|
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::
|
.. warning::
|
||||||
|
|
||||||
**Les tunnels ne survivent pas à la perte du route reflector.** Avec un seul route reflector
|
**Les tunnels ne survivent pas à la perte de tous les route reflectors.** Sans
|
||||||
et sans ``graceful-restart``, à l'arrêt de FRR sur le route reflector, la session EVPN des
|
``graceful-restart``, quand plus aucun route reflector ne répond, les sessions 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
|
hyperviseurs tombent, FRR retire les routes apprises et, avec elles, le VTEP distant et
|
||||||
aucun paquet ne passe** entre hyperviseurs, à 30 s comme à 90 s. Au redémarrage de FRR sur le
|
l'entrée d'inondation du VXLAN : **plus aucun paquet ne passe** entre hyperviseurs, jusqu'au
|
||||||
route reflector, VTEP distant et trafic reviennent **31 s** plus tard. Le trafic entre VM d'un
|
retour d'un route reflector et à la reconvergence des sessions. Le trafic entre VM d'un même
|
||||||
même hyperviseur n'est pas concerné. La redondance (deux route reflectors) ou
|
hyperviseur n'est pas concerné. Avec deux route reflectors, la perte de l'un est sans effet sur
|
||||||
``graceful-restart`` sont les deux leviers ; ni l'un ni l'autre n'est encore qualifié.
|
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::
|
.. 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` ;
|
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
|
* 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 ;
|
hyperviseur dont la perte isolerait l'autre ;
|
||||||
* la procédure de reconstruction — l'état du cluster pendant l'absence du route reflector est
|
* la procédure de reconstruction — l'état du cluster pendant l'absence de tous les route
|
||||||
décrit ci-dessus : plus de trafic entre hyperviseurs ;
|
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
|
* 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
|
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`.
|
n'existe pas, cf. :doc:`premier-hyperviseur`.
|
||||||
|
|
|
||||||
|
|
@ -18,9 +18,10 @@ Routeurs de bordure
|
||||||
Routeur de cluster
|
Routeur de cluster
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des deux route
|
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des route reflectors
|
||||||
reflectors, dont il apprend les loopbacks : c'est par lui que chaque hyperviseur joint
|
— au moins un ; deux sont prévus dans l'architecture et dans les exemples —, dont il apprend les
|
||||||
``10.255.255.1`` et ``10.255.255.2`` pour ouvrir ses sessions EVPN (:doc:`route-reflector`).
|
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
|
Adressage
|
||||||
~~~~~~~~~
|
~~~~~~~~~
|
||||||
|
|
@ -33,8 +34,9 @@ Adressage
|
||||||
- Interface
|
- Interface
|
||||||
- Rôle
|
- Rôle
|
||||||
* - ``192.168.14.1/24``
|
* - ``192.168.14.1/24``
|
||||||
- interface du segment des hyperviseurs
|
- interface du segment des hyperviseurs, **adresse virtuelle VRRP**
|
||||||
- passerelle par défaut des hyperviseurs et du route reflector
|
- 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``
|
* - ``169.254.0.1/28``
|
||||||
- même interface, **adresse secondaire**
|
- même interface, **adresse secondaire**
|
||||||
- lien avec les route reflectors (``169.254.0.3`` et ``.4``) ; ``router-id`` ; le second
|
- 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.
|
* **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
|
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
|
``router-id`` (``169.254.0.2``), que les route reflectors déclarent aussi. Les deux routeurs se
|
||||||
routeurs — et le mécanisme qui fait basculer la passerelle ``192.168.14.1`` — est l'objet de
|
partagent la passerelle ``192.168.14.1`` en **VRRP v3** : le maître la porte, l'autre attend, sans
|
||||||
`#54 <https://git.g3e.fr/syonad/two/issues/54>`_.
|
préemption (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_, fermé).
|
||||||
|
|
||||||
.. note::
|
.. 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 :
|
**À 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
|
* pour le routeur de cluster : le matériel employé et sa version de référence ; la traduction
|
||||||
— deux routeurs, mécanisme de bascule, comportement attendu pendant une bascule
|
de la redondance VRRP v3 dans sa configuration ;
|
||||||
(`#54 <https://git.g3e.fr/syonad/two/issues/54>`_) ;
|
|
||||||
* pour les routeurs de datacentre et de bordure : tout — équipement, configuration de
|
* pour les routeurs de datacentre et de bordure : tout — équipement, configuration de
|
||||||
référence, ce qui est annoncé et filtré à chaque niveau, redondance ;
|
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
|
* 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é,
|
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
|
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 —
|
: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.
|
l'heure.
|
||||||
|
|
||||||
Le pourquoi des choix (serveur physique plutôt que VM cloud, câbles QEMU, MTU 9000, versions) est
|
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.
|
`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
|
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
|
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
|
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
|
.. literalinclude:: ../../test/e2e/topologies/evpn-2hv.yml
|
||||||
:language: yaml
|
: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
|
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
|
``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``,
|
**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
|
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
|
``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
|
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
|
maître, sans préemption (``no vrrp 1 preempt``) — voir la section du guide de labctl sur les
|
||||||
``frr.conf`` ne diffèrent que par ``hostname`` et ``router-id`` ; labctl y ajoute la strophe VRRP.
|
routeurs. Leurs ``frr.conf`` ne diffèrent que par ``hostname`` et ``router-id`` ; labctl y ajoute
|
||||||
|
la strophe VRRP.
|
||||||
|
|
||||||
Rôles
|
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** :
|
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
|
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`` :
|
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
|
la configuration BGP est posée par l'agent (section ``bgp`` de ``agent.yml``). Celle du premier
|
||||||
reflector :
|
route reflector (celle de ``rr2`` ne diffère que par son nom et sa loopback) :
|
||||||
|
|
||||||
.. literalinclude:: ../../test/e2e/topologies/frr/rr1.conf
|
.. literalinclude:: ../../test/e2e/topologies/frr/rr1.conf
|
||||||
:language: text
|
: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 all # toute la suite, dans l'ordre
|
||||||
test/e2e/run.sh 40 # une couche
|
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 --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 --continue all # sans s'arrêter sur une couche en échec
|
||||||
test/e2e/run.sh --connus all # les échecs connus comptent comme des échecs
|
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
|
(#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) ;
|
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
|
* #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``
|
* une suppression de VM peut durer 300 s quand l'invité ignore l'arrêt ACPI (#79) : ``wait_state``
|
||||||
attend jusqu'à 360 s.
|
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'``.
|
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/`` :
|
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,
|
* ``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 :
|
``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
|
``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 ;
|
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 ;
|
* ``net.sh`` : VPC, subnets, MAC anycast, trames brutes, règles ebtables, VRRP ;
|
||||||
* ``evpn.sh`` : VRF, BGP, L3VNI, watchdog ;
|
* ``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
|
.. 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
|
# hôtes: hv1
|
||||||
# tickets: #NN
|
# 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 "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 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 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
|
NODE
|
||||||
|
|
||||||
Les règles :
|
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.
|
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
|
* **Traiter ``error`` comme terminal, pas comme un échec transitoire.** Un ``Execute`` en échec
|
||||||
ne se rejoue pas tout seul.
|
ne se rejoue pas tout seul.
|
||||||
* **Ne pas enchaîner sans vérifier.** Créer un subnet dont le VPC est encore en ``creating``
|
* **Savoir ce qui s'enchaîne.** Créer un subnet dont le VPC est encore en ``creating``, ou
|
||||||
échoue en 422 ; démarrer une VM sur un subnet en ``creating`` ou ``running`` est en revanche
|
démarrer une VM sur un subnet en ``creating``, est accepté : l'``Execute`` attend que le parent
|
||||||
accepté.
|
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
|
Codes de retour
|
||||||
---------------
|
---------------
|
||||||
|
|
@ -66,15 +67,23 @@ Codes de retour
|
||||||
* - ``200``
|
* - ``200``
|
||||||
- lecture réussie (``GET``)
|
- lecture réussie (``GET``)
|
||||||
* - ``400``
|
* - ``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``
|
* - ``404``
|
||||||
- ressource inexistante
|
- 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``
|
* - ``409``
|
||||||
- conflit d'existence ou d'état : ressource déjà créée, ou suppression depuis un état qui
|
- 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
|
ne l'autorise pas ; pour un VPC, subnets encore présents, ``l3vni`` déjà utilisée par un
|
||||||
supprimées qui l'utilisent encore
|
autre VPC, ou ``l3vni`` demandée sans section ``bgp`` ; pour un subnet, VM non supprimées
|
||||||
|
qui l'utilisent encore
|
||||||
* - ``422``
|
* - ``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``
|
* - ``500``
|
||||||
- erreur interne
|
- erreur interne
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -173,7 +173,7 @@ Metadata et QEMU
|
||||||
qemu:
|
qemu:
|
||||||
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
ovmf_code_path: "/usr/share/OVMF/OVMF_CODE.fd"
|
||||||
ovmf_vars_template: "/usr/share/OVMF/OVMF_VARS.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"
|
serial_dir: "/run/two/vms/serial"
|
||||||
monitor_dir: "/run/two/vms/monitor"
|
monitor_dir: "/run/two/vms/monitor"
|
||||||
qmp_dir: "/run/two/vms/qmp"
|
qmp_dir: "/run/two/vms/qmp"
|
||||||
|
|
@ -257,6 +257,7 @@ Watchdog
|
||||||
interval_seconds: 60
|
interval_seconds: 60
|
||||||
|
|
||||||
Vérification périodique **en lecture seule** — voir :doc:`/exploitation/observabilite`.
|
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
|
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
|
# Ce qu'il enverrait à une MAC donnée, sans effet de bord
|
||||||
echo '{"verb":"probe","mac":"00:22:33:00:00:0A"}' \
|
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
|
``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
|
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
|
cloud-init query instance-id
|
||||||
ls /var/lib/cloud/instances/
|
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
|
.. code-block:: bash
|
||||||
|
|
||||||
ip route
|
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
|
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
|
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
|
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
|
C'est le comportement attendu quand ``user_data`` est absent ou vide à la création : les deux cas
|
||||||
absent, qui retombe sur le template. Vérifier le contenu réellement écrit :
|
sont équivalents, et aucun template ne prend le relais pour ``user-data``. Vérifier le contenu
|
||||||
|
réellement écrit :
|
||||||
|
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
|
|
@ -150,7 +153,7 @@ La VM ne démarre pas (UEFI)
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
ls -l /usr/share/OVMF/OVMF_CODE.fd /usr/share/OVMF/OVMF_VARS.fd
|
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``.
|
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
|
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
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
|
@ -72,17 +73,20 @@ Journaux
|
||||||
|
|
||||||
journalctl -u agent -f
|
journalctl -u agent -f
|
||||||
journalctl -u 'metadata@i-web' -n 50
|
journalctl -u 'metadata@i-web' -n 50
|
||||||
tail -f /var/log/dnsmasq-vp-admin_br-sn000001.log # backend dnsmasq
|
tail -f /var/log/dnsmasq-vp-admin_br-000001.log # backend dnsmasq
|
||||||
journalctl -fu 'dhcp@vp-admin_br-sn000001' # backend two
|
journalctl -fu 'dhcp@vp-admin_br-000001' # backend two
|
||||||
|
|
||||||
Inspection de la base
|
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
|
.. 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::
|
.. warning::
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,8 @@
|
||||||
Services systemd
|
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`).
|
s'excluent : celle qui tourne dépend de ``dhcp.backend`` (voir :doc:`configuration`).
|
||||||
|
|
||||||
.. list-table::
|
.. list-table::
|
||||||
|
|
@ -30,8 +31,8 @@ n'y a pas à les démarrer à la main en fonctionnement normal.
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
systemctl status agent
|
systemctl status agent
|
||||||
systemctl status 'dnsmasq@vp-admin_br-sn000001' # backend dnsmasq
|
systemctl status 'dnsmasq@vp-admin_br-000001' # backend dnsmasq
|
||||||
systemctl status 'dhcp@vp-admin_br-sn000001' # backend two
|
systemctl status 'dhcp@vp-admin_br-000001' # backend two
|
||||||
systemctl status 'metadata@i-web'
|
systemctl status 'metadata@i-web'
|
||||||
|
|
||||||
dnsmasq
|
dnsmasq
|
||||||
|
|
@ -65,9 +66,9 @@ ignore le netns dans lequel il tourne :
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
/opt/two/bin/dhcp -conf /etc/two/agent.yml \
|
/opt/two/bin/dhcp -conf /etc/two/agent.yml \
|
||||||
-interface br-sn000001 \
|
-interface br-000001 \
|
||||||
-state /run/two/dhcp/vp-admin_br-sn000001.state \
|
-state /run/two/dhcp/vp-admin_br-000001.state \
|
||||||
-socket /run/two/dhcp/vp-admin_br-sn000001.sock
|
-socket /run/two/dhcp/vp-admin_br-000001.sock
|
||||||
|
|
||||||
.. list-table::
|
.. list-table::
|
||||||
:widths: 40 60
|
: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>
|
<style>
|
||||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
.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; }
|
.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="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="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="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)"/>
|
<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="72" text-anchor="middle">eBGP · BFD</text>
|
||||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</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"/>
|
<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="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>
|
<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"/>
|
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
<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="552.0" text-anchor="middle">dans br-<subnet>, sans learning</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"/>
|
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
<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="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>
|
<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"/>
|
<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="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</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"/>
|
<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="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>
|
<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"/>
|
<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="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>
|
<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"/>
|
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
<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="552.0" text-anchor="middle">dans br-<subnet>, sans learning</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"/>
|
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
<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="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>
|
<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"/>
|
<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="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</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"/>
|
<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="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>
|
<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>
|
<style>
|
||||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
.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; }
|
.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="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="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="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)"/>
|
<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="72" text-anchor="middle">eBGP · BFD</text>
|
||||||
<text class="ctrlt" x="560" y="98" text-anchor="middle">loopbacks seules</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"/>
|
<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="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>
|
<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"/>
|
<rect class="box" x="60" y="510" width="180" height="66" rx="6"/>
|
||||||
<text class="lbl" x="150.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
<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="552.0" text-anchor="middle">dans br-<subnet>, sans learning</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"/>
|
<rect class="group" x="270" y="280" width="290" height="300" rx="8"/>
|
||||||
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
<text class="grp" x="290" y="304">NETNS DU VPC</text>
|
||||||
<rect class="box" x="285" y="312" width="125" height="66" rx="6"/>
|
<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="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>
|
<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"/>
|
<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="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</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"/>
|
<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="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>
|
<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"/>
|
<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="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>
|
<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"/>
|
<rect class="box" x="640" y="510" width="180" height="66" rx="6"/>
|
||||||
<text class="lbl" x="730.0" y="535.0" text-anchor="middle">vxlan-<vni></text>
|
<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="552.0" text-anchor="middle">dans br-<subnet>, sans learning</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"/>
|
<rect class="group" x="850" y="280" width="290" height="300" rx="8"/>
|
||||||
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
<text class="grp" x="870" y="304">NETNS DU VPC</text>
|
||||||
<rect class="box" x="865" y="312" width="125" height="66" rx="6"/>
|
<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="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>
|
<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"/>
|
<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="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</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"/>
|
<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="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>
|
<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>
|
<style>
|
||||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #e6edf3; }
|
.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; }
|
.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"/>
|
<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="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="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>
|
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
<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"/>
|
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
<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="link" d="M300 635 V460"/>
|
||||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
<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>
|
<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"/>
|
<path class="data" d="M60 1045 H110"/>
|
||||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||||
<path class="ctrl" d="M290 1045 H340"/>
|
<path class="ctrl" d="M290 1045 H340"/>
|
||||||
|
|
@ -184,10 +186,10 @@
|
||||||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
<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"/>
|
<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="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="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="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="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="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>
|
</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>
|
<style>
|
||||||
.lbl { font-family: -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 14px; fill: #1f2328; }
|
.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; }
|
.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"/>
|
<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="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="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>
|
<path class="net" d="M1180 64 H900" marker-end="url(#a-net)"/>
|
||||||
<text class="nett" x="1164" y="166" text-anchor="end">par Internet et les bordures (VNI 66001)</text>
|
<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"/>
|
<rect class="group" x="40" y="280" width="480" height="130" rx="8"/>
|
||||||
<text class="grp" x="60" y="304">CLUSTER A</text>
|
<text class="grp" x="60" y="304">CLUSTER A</text>
|
||||||
<rect class="box" x="60" y="312" width="210" height="56" rx="6"/>
|
<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="link" d="M300 635 V460"/>
|
||||||
<path class="orch" d="M320 785 H332 V410" marker-end="url(#a-orch)"/>
|
<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>
|
<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"/>
|
<path class="data" d="M60 1045 H110"/>
|
||||||
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
<text class="sub" x="118" y="1049" text-anchor="start">plan de données : VXLAN</text>
|
||||||
<path class="ctrl" d="M290 1045 H340"/>
|
<path class="ctrl" d="M290 1045 H340"/>
|
||||||
|
|
@ -184,10 +186,10 @@
|
||||||
<text class="sub" x="748" y="1049" text-anchor="start">trafic Internet</text>
|
<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"/>
|
<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="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="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="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="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="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>
|
</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, 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, 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, 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.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 + 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 + 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.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.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)"])
|
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(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.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, 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.path("M480 80 H640", "ctrl", start=True, end=True)
|
||||||
g.text(560, 72, "eBGP · BFD", "ctrlt", "middle")
|
g.text(560, 72, "eBGP · BFD", "ctrlt", "middle")
|
||||||
|
|
@ -91,7 +92,7 @@ def draw():
|
||||||
def render(p):
|
def render(p):
|
||||||
g.out.clear()
|
g.out.clear()
|
||||||
draw()
|
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(
|
st = g.style(p).replace(" </style>", made_style(p) + " </style>").replace(
|
||||||
" </defs>",
|
" </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>')
|
' <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():
|
def draw():
|
||||||
dy = 205
|
dy = 205
|
||||||
|
|
||||||
# Internet et bordures
|
|
||||||
out.append(' <rect class="pill" x="600" y="20" width="300" height="56" rx="28"/>')
|
out.append(' <rect class="pill" x="600" y="20" width="300" height="56" rx="28"/>')
|
||||||
text(750, 54, "Internet", "lbl", "middle")
|
text(750, 54, "Internet", "lbl", "middle")
|
||||||
path("M750 76 V110", "net", start=True, end=True)
|
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, 214, "même IP et même MAC de gateway · sans état", "sub", "middle")
|
||||||
text(750, 230, "VTEP · VNI 66001 (public)", "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")
|
group(1180, 20, 280, 100, "POSTE DE L'OPÉRATEUR")
|
||||||
box(1200, 50, 240, 52, "Terraform / OpenTofu", ["provider two · #72"], "future")
|
box(1200, 50, 240, 52, "Terraform / OpenTofu", ["provider two · #72"], "future")
|
||||||
text(1164, 150, "API publique de l'orchestrateur", "nett", "end")
|
path("M1180 64 H900", "net", end=True)
|
||||||
text(1164, 166, "par Internet et les bordures (VNI 66001)", "nett", "end")
|
text(1040, 56, "API publique de l'orchestrateur", "nett", "middle")
|
||||||
|
|
||||||
# Underlay A : routeurs
|
|
||||||
group(40, 280, 480, 130, "CLUSTER A")
|
group(40, 280, 480, 130, "CLUSTER A")
|
||||||
box(60, 312, 210, 56, "routeur 1", ["169.254.0.1/28"])
|
box(60, 312, 210, 56, "routeur 1", ["169.254.0.1/28"])
|
||||||
box(290, 312, 210, 56, "routeur 2", ["169.254.0.2/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")
|
text(280, 392, "VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72", "sub", "middle")
|
||||||
|
|
||||||
# Underlay B
|
|
||||||
group(1200, 280, 260, 130, "CLUSTER B")
|
group(1200, 280, 260, 130, "CLUSTER B")
|
||||||
box(1215, 312, 110, 56, "routeur 1", ["169.254.0.1/28"])
|
box(1215, 312, 110, 56, "routeur 1", ["169.254.0.1/28"])
|
||||||
box(1335, 312, 110, 56, "routeur 2", ["169.254.0.2/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")
|
text(1330, 765 + dy, "l'hyperviseur détaillé", "sub", "middle")
|
||||||
path(f"M1452 460 V{395 + dy}", "link")
|
path(f"M1452 460 V{395 + dy}", "link")
|
||||||
|
|
||||||
# eBGP
|
|
||||||
path("M500 340 H1215", "link")
|
path("M500 340 H1215", "link")
|
||||||
text(860, 332, "eBGP · routeur 2 de A → routeur 1 de B", "sub", "middle")
|
text(860, 332, "eBGP · routeur 2 de A → routeur 1 de B", "sub", "middle")
|
||||||
path("M660 240 V258 H210 V312", "link")
|
path("M660 240 V258 H210 V312", "link")
|
||||||
|
|
@ -130,7 +125,6 @@ def draw():
|
||||||
text(420, 252, "eBGP", "sub", "middle")
|
text(420, 252, "eBGP", "sub", "middle")
|
||||||
text(1060, 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"/>')
|
out.append(' <line class="bus" x1="40" y1="460" x2="680" y2="460"/>')
|
||||||
text(690, 465, "underlay A · VXLAN UDP 4789 · BGP", "sub")
|
text(690, 465, "underlay A · VXLAN UDP 4789 · BGP", "sub")
|
||||||
path("M75 368 V460", "link")
|
path("M75 368 V460", "link")
|
||||||
|
|
@ -145,7 +139,6 @@ def draw():
|
||||||
path("M510 410 V546 H760", "orch", end=True)
|
path("M510 410 V546 H760", "orch", end=True)
|
||||||
path("M1200 400 H1192 V560 H1180", "orch", end=True)
|
path("M1200 400 H1192 V560 H1180", "orch", end=True)
|
||||||
|
|
||||||
# Hyperviseur
|
|
||||||
group(40, 395 + dy, 1120, 410, "HYPERVISEUR A (détaillé)")
|
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, 430 + dy, 260, 52, "br-000000", ["IP de l'hyperviseur = VTEP"])
|
||||||
box(60, 496 + dy, 260, 52, "FRR · bgpd", ["sessions EVPN vers les RR"])
|
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>')
|
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")
|
path(f"M300 {430 + dy} V460", "link")
|
||||||
|
|
||||||
# Orchestration : agent → routeurs de l'underlay A
|
|
||||||
path(f"M320 {580 + dy} H332 V410", "orch", end=True)
|
path(f"M320 {580 + dy} H332 V410", "orch", end=True)
|
||||||
text(340, 596, "register · ordres · événements (mTLS, sortant)", "orcht")
|
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
|
ly = 840 + dy
|
||||||
path(f"M60 {ly} H110", "data")
|
path(f"M60 {ly} H110", "data")
|
||||||
text(118, ly + 4, "plan de données : VXLAN")
|
text(118, ly + 4, "plan de données : VXLAN")
|
||||||
|
|
@ -194,12 +187,12 @@ def draw():
|
||||||
text(922, ly + 4, "à venir (ticket indiqué)")
|
text(922, ly + 4, "à venir (ticket indiqué)")
|
||||||
|
|
||||||
notes = [
|
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.",
|
"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 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.",
|
"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.",
|
"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):
|
for k, n in enumerate(notes):
|
||||||
text(60, 884 + dy + k * 18, n)
|
text(60, 884 + dy + k * 18, n)
|
||||||
|
|
@ -208,7 +201,7 @@ def draw():
|
||||||
def render(p):
|
def render(p):
|
||||||
out.clear()
|
out.clear()
|
||||||
draw()
|
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>", ""])
|
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.**
|
- **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
|
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
|
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
|
- `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
|
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
|
- **Le serveur DHCP intégré s'arrête proprement** sur `SIGTERM` et `SIGINT` : il ferme sa socket de
|
||||||
|
|
|
||||||