From 7d79ba1a5e665d2f531e854f62b726417acf48ea Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Sun, 25 Oct 2026 23:47:54 +0100 Subject: [PATCH] f-87: doc: plan de VNI (1 public), -N, interfaces.internet, notes 0.3.0 #87 Signed-off-by: GnomeZworc --- docs/concepts/vpc-subnet-vm.rst | 22 +++++++++++++--------- docs/demarrage/installation.rst | 22 ++++++++++++++++------ docs/deploiement/architecture-cluster.rst | 9 +++++---- docs/exploitation/configuration.rst | 7 ++++++- docs/exploitation/observabilite.rst | 5 ++++- release_notes/0.3.0.md | 19 +++++++++++++++++++ 6 files changed, 63 insertions(+), 21 deletions(-) diff --git a/docs/concepts/vpc-subnet-vm.rst b/docs/concepts/vpc-subnet-vm.rst index 0c9e850..69bcc1a 100644 --- a/docs/concepts/vpc-subnet-vm.rst +++ b/docs/concepts/vpc-subnet-vm.rst @@ -18,11 +18,12 @@ VPC Un VPC est un **network namespace** portant un espace d'adressage (``cidr``). C'est l'unité d'isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d'adresses. -À la création, l'agent relie le netns au bridge ``br-public`` de l'host par un veth -``vp--e`` (côté host) ↔ ``vp--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. +À la création, l'agent relie le netns au **bridge public** de l'host par un veth ``vp--e`` +(côté host) ↔ ``vp--i`` (côté netns, rattaché à un ``br-public`` propre au netns). Le bridge +public est celui de ``interfaces.internet``, ``br-public`` si la clé est absente, jamais +``default_interface`` (:doc:`/exploitation/configuration`). ``deploy.sh -i`` le crée et y +accroche ``vxlan-public``, le VXLAN du segment public partagé avec les bordures +(:doc:`/demarrage/installation`) ; sans ce bridge, toute création de VPC échoue. Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409. @@ -35,10 +36,13 @@ plus besoin de porter un subnet pour joindre ses VM. Sans ``l3vni``, le VPC se c avant. Le champ exige la section ``bgp`` de l'agent (:doc:`/exploitation/configuration`) et ne se change pas après création. -**Plan de VNI.** L3VNI et ``vxlan_id`` des subnets partagent l'espace des VNI VXLAN : la plage -**1–65535** (sauf 253–255, tables du noyau) est réservée aux L3VNI des VPC, **65536–16777215** aux -subnets. L'agent n'impose que la première borne (le RD ``:`` porte un numéro sur -16 bits) ; le respect du plan revient à l'appelant, qui alloue les deux. +**Plan de VNI.** Segment public, L3VNI et ``vxlan_id`` des subnets partagent l'espace des VNI +VXLAN : le VNI **1** est celui du segment public (``deploy.sh --public_vni``, 1 par défaut), la +plage **2–65535** (sauf 253–255, tables du noyau) est réservée aux L3VNI des VPC, +**65536–16777215** aux subnets. L'agent n'impose que la borne haute des L3VNI (le RD +``:`` porte un numéro sur 16 bits) ; le respect du plan revient à l'appelant, qui +alloue les L3VNI et les ``vxlan_id``. Un VPC créé avec le VNI du segment public pour ``l3vni`` +passe en ``error`` : ce VNI est déjà porté par ``vxlan-public``. À la création, l'agent pose sur l'hyperviseur, pour un VPC ``vp-`` : diff --git a/docs/demarrage/installation.rst b/docs/demarrage/installation.rst index ecb8030..579896e 100644 --- a/docs/demarrage/installation.rst +++ b/docs/demarrage/installation.rst @@ -50,9 +50,12 @@ depuis la release, et les vérifie contre le manifeste ``SHA256SUMS``. - bridge principal, auquel l'uplink est rattaché - ``br-000000`` * - ``-P `` - - bridge supplémentaire, créé vide et réservé ; garder ``br-public``, nom attendu par - l'agent (voir ci-dessous) + - bridge public, sans adresse : il porte ``vxlan-public`` et les veth des VPC ; à + reporter dans ``interfaces.internet`` s'il change (voir ci-dessous) - ``br-public`` + * - ``-N `` + - VNI du segment public, partagé avec les bordures (``vxlan-public``) + - ``1`` * - ``-R `` - délai avant le redémarrage de secours pendant la migration réseau - ``120`` @@ -89,12 +92,19 @@ en arrière. Voir :doc:`/exploitation/configuration`. le serveur de metadata : sans elle, iptables ne voit pas le trafic bridgé des VM et cloud-init ne se provisionne pas. Contrepartie assumée : tout le trafic inter-VM traverse les tables NAT. -**Réseau** — création du bridge réservé, puis rattachement de l'uplink au bridge principal, +**Réseau** — création du bridge public, puis rattachement de l'uplink au bridge principal, l'adresse et la route par défaut étant déplacées de l'interface physique vers le bridge. -Le nom ``br-public`` est **en dur dans l'agent** : chaque VPC ``vp-`` y raccorde un veth -``vp--e`` côté host, dont l'autre extrémité ``vp--i`` rejoint un ``br-public`` créé dans -le netns du VPC. Avec un autre nom passé à ``-P``, toute création de VPC échoue. +**Segment public** — ``vxlan-public`` est créé avec le VNI de ``-N``, l'adresse IPv4 du bridge +principal pour VTEP (comme les VXLAN de l'agent), le port 4789, sans apprentissage (les MAC +distantes viennent d'EVPN) et un MTU de 1500, puis rattaché au bridge public. FRR l'annonce de +lui-même (``advertise-all-vni``). Relancer ``-i`` ne change rien ; le VXLAN est recréé si son VNI +ou son VTEP a changé. + +Chaque VPC ``vp-`` raccorde au bridge public un veth ``vp--e`` côté host, dont l'autre +extrémité ``vp--i`` rejoint un ``br-public`` créé dans le netns du VPC. L'agent lit le nom +du bridge public dans ``interfaces.internet`` (``br-public`` par défaut) : avec un autre nom +passé à ``-P`` sans le reporter dans cette clé, toute création de VPC échoue. .. danger:: diff --git a/docs/deploiement/architecture-cluster.rst b/docs/deploiement/architecture-cluster.rst index d0898dd..cea5769 100644 --- a/docs/deploiement/architecture-cluster.rst +++ b/docs/deploiement/architecture-cluster.rst @@ -30,8 +30,9 @@ encore est décrit sur son ticket : * **Internet** (`#31 `_, `#42 `_). Les bordures partagent avec les hyperviseurs - un VXLAN public (VNI 66001) et portent toutes la même IP et la même MAC de gateway. Elles restent - sans état : tout NAT vit sur un hyperviseur. Trois façons de sortir : + un VXLAN public (VNI 1, ``vxlan-public`` sur ``br-public``, #87) et portent toutes la même IP et + la même MAC de gateway. Elles restent sans état : tout NAT vit sur un hyperviseur. Trois façons + de sortir : * une VM qui porte une IP publique a une NIC sur un subnet public de son VPC, relié au subnet public de l'hôte ; @@ -43,7 +44,8 @@ encore est décrit sur son ticket : 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 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 segment public (VNI 1) : son API est joignable + depuis Internet. * **Route reflectors.** Au moins un ; deux sont prévus dans l'architecture et dans les exemples (plages d'adresses de :doc:`route-reflector`), placés ici dans deux clusters différents pour @@ -172,5 +174,4 @@ Adressage * la plage utilisée pour les adresses d'hyperviseurs, et son rapport avec ``br-000000`` ; * l'allocation des VNI VXLAN : qui la tient, et comment on évite les collisions, puisque l'agent ne valide pas ``vxlan_id`` ; - * l'usage prévu de ``br-public``, créé vide et réservé par le bootstrap ; * le plan d'adressage des VPC, et ce qui garantit qu'ils ne se recouvrent pas entre clients. diff --git a/docs/exploitation/configuration.rst b/docs/exploitation/configuration.rst index fcbdc61..9b13092 100644 --- a/docs/exploitation/configuration.rst +++ b/docs/exploitation/configuration.rst @@ -125,13 +125,18 @@ Correspondance des interfaces interfaces: vms: br-000000 - internet: br-000000 + internet: br-public admin: br-000000 Traduit les clés logiques ``iface_type`` de l'API vers les bridges physiques de l'host. Une clé inconnue ou omise retombe silencieusement sur ``default_interface`` — ce n'est pas une erreur, mais c'est une source de subnets branchés au mauvais endroit sans le dire. +``internet`` désigne aussi le **bridge public**, celui qui porte ``vxlan-public`` et où chaque +VPC raccorde son veth ``vp--e`` (:doc:`/concepts/vpc-subnet-vm`). Pour lui, une clé absente +ou vide vaut ``br-public``, **jamais** ``default_interface`` : le segment public ne doit pas +tomber sur l'underlay. À garder égal au ``-P`` de ``deploy.sh``. + MTU --- diff --git a/docs/exploitation/observabilite.rst b/docs/exploitation/observabilite.rst index 34c1197..8f336be 100644 --- a/docs/exploitation/observabilite.rst +++ b/docs/exploitation/observabilite.rst @@ -37,7 +37,10 @@ défaut** (``enabled: false``) ; l'activer explicitement : interval_seconds: 60 Il contrôle notamment l'existence des network namespaces, des liens réseau des subnets, des taps -de VM et la réponse des units systemd associées. +de VM et la réponse des units systemd associées, ainsi que le **segment public** : le bridge +public (``interfaces.internet``) doit exister, être actif et porter un port VXLAN +(``vxlan-public``), sinon les VPC de l'hôte n'ont pas de segment public. Il ne vérifie pas le +numéro du VNI. Avec une section ``bgp`` dans la configuration, il contrôle aussi le plan de contrôle : diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index 8038a58..e54f7ee 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -14,6 +14,18 @@ quand ses VM sont en `deleting`, et attend leur suppression jusqu'à `timeout_subnet_stop`. Le 409 reste pour une VM ni supprimée ni en `deleting` +**Segment public de l'hôte (#87)** + +- `deploy.sh -i` crée `vxlan-public`, VXLAN du segment public partagé avec les bordures, sur le + bridge public (`-P`, `br-public`) : VNI de la nouvelle option `-N`/`--public_vni` (1 par + défaut), VTEP = IPv4 du bridge principal, sans apprentissage ; recréé si le VNI ou le VTEP + change. FRR l'annonce par `advertise-all-vni` +- Plan de VNI : 1 pour le segment public, 2–65535 pour les L3VNI, 65536 et au-delà pour les + subnets. L'agent ne vérifie pas : l'appelant n'alloue jamais le VNI du segment public +- L'agent raccorde le veth `vp--e` de chaque VPC au bridge de `interfaces.internet` + (`br-public` par défaut, jamais `default_interface`), au lieu d'un nom en dur +- Le watchdog signale un bridge public absent, éteint ou sans port VXLAN + ## Correctifs - **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait @@ -40,6 +52,13 @@ ## Mise à jour depuis la 0.2.0 +- **Relancer `deploy.sh -i` (#87)** sur chaque hyperviseur pour créer `vxlan-public` ; sans lui, + le watchdog signale un bridge public sans port VXLAN à chaque tick. Un VPC routé dont le + `l3vni` vaut 1 doit être recréé avec un autre L3VNI avant : sinon la création de + `vxlan-public` échoue sur ce VNI déjà porté +- **`interfaces.internet` désigne désormais le bridge public (#87)** : une valeur héritée de + l'ancien exemple (`internet: br-000000`) raccorderait les VPC à l'underlay. La retirer, ou la + mettre à `br-public` - **`default_route: true` exige une `gateway` hors mode `bridge`** : un appel qui l'omettait en `vxlan` reçoit désormais un 400. Les subnets existants gardent la route par défaut qu'ils annonçaient jusqu'à leur recréation