f-87: doc: plan de VNI (1 public), -N, interfaces.internet, notes 0.3.0 #87

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-25 23:47:54 +01:00
commit 7d79ba1a5e
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
6 changed files with 63 additions and 21 deletions

View file

@ -18,11 +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 À la création, l'agent relie le netns au **bridge public** de l'host par un veth ``vp-<id>-e``
``vp-<id>-e`` (côté host) ↔ ``vp-<id>-i`` (côté netns, rattaché à un ``br-public`` propre au (côté host) ↔ ``vp-<id>-i`` (côté netns, rattaché à un ``br-public`` propre au netns). Le bridge
netns). Ce nom de bridge est **en dur** : l'host doit porter un bridge ``br-public``, celui que public est celui de ``interfaces.internet``, ``br-public`` si la clé est absente, jamais
crée ``deploy.sh -i`` avec la valeur par défaut de ``-P`` (:doc:`/demarrage/installation`) ; ``default_interface`` (:doc:`/exploitation/configuration`). ``deploy.sh -i`` le crée et y
sans lui, toute création de VPC échoue. 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. 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 avant. Le champ exige la section ``bgp`` de l'agent (:doc:`/exploitation/configuration`) et ne
se change pas après création. se change pas après création.
**Plan de VNI.** L3VNI et ``vxlan_id`` des subnets partagent l'espace des VNI VXLAN : la plage **Plan de VNI.** Segment public, L3VNI et ``vxlan_id`` des subnets partagent l'espace des VNI
**1–65535** (sauf 253–255, tables du noyau) est réservée aux L3VNI des VPC, **65536–16777215** aux VXLAN : le VNI **1** est celui du segment public (``deploy.sh --public_vni``, 1 par défaut), la
subnets. L'agent n'impose que la première borne (le RD ``<VTEP>:<l3vni>`` porte un numéro sur plage **2–65535** (sauf 253–255, tables du noyau) est réservée aux L3VNI des VPC,
16 bits) ; le respect du plan revient à l'appelant, qui alloue les deux. **65536–16777215** aux subnets. L'agent n'impose que la borne haute des L3VNI (le RD
``<VTEP>:<l3vni>`` 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-<id>`` : À la création, l'agent pose sur l'hyperviseur, pour un VPC ``vp-<id>`` :

View file

@ -50,9 +50,12 @@ 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é ; garder ``br-public``, nom attendu par - bridge public, sans adresse : il porte ``vxlan-public`` et les veth des VPC ; à
l'agent (voir ci-dessous) reporter dans ``interfaces.internet`` s'il change (voir ci-dessous)
- ``br-public`` - ``br-public``
* - ``-N <vni>``
- VNI du segment public, partagé avec les bordures (``vxlan-public``)
- ``1``
* - ``-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
- ``120`` - ``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 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. 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. 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 **Segment public** — ``vxlan-public`` est créé avec le VNI de ``-N``, l'adresse IPv4 du bridge
``vp-<id>-e`` côté host, dont l'autre extrémité ``vp-<id>-i`` rejoint un ``br-public`` créé dans principal pour VTEP (comme les VXLAN de l'agent), le port 4789, sans apprentissage (les MAC
le netns du VPC. Avec un autre nom passé à ``-P``, toute création de VPC échoue. 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-<id>`` raccorde au bridge public 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. 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:: .. danger::

View file

@ -30,8 +30,9 @@ 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
un VXLAN public (VNI 66001) et portent toutes la même IP et la même MAC de gateway. Elles restent un VXLAN public (VNI 1, ``vxlan-public`` sur ``br-public``, #87) et portent toutes la même IP et
sans état : tout NAT vit sur un hyperviseur. Trois façons de sortir : 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 * 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 ; 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 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 **en sortie**, par leur passerelle ; les routeurs de chaque cluster les traduisent (NAT) vers le
VNI 66000. 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 * **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 (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`` ; * 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'allocation des VNI VXLAN : qui la tient, et comment on évite les collisions, puisque
l'agent ne valide pas ``vxlan_id`` ; 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. * le plan d'adressage des VPC, et ce qui garantit qu'ils ne se recouvrent pas entre clients.

View file

@ -125,13 +125,18 @@ Correspondance des interfaces
interfaces: interfaces:
vms: br-000000 vms: br-000000
internet: br-000000 internet: br-public
admin: br-000000 admin: br-000000
Traduit les clés logiques ``iface_type`` de l'API vers les bridges physiques de l'host. Une clé 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, 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. 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-<id>-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 MTU
--- ---

View file

@ -37,7 +37,10 @@ défaut** (``enabled: false``) ; l'activer explicitement :
interval_seconds: 60 interval_seconds: 60
Il contrôle notamment l'existence des network namespaces, des liens réseau des subnets, des taps 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 : Avec une section ``bgp`` dans la configuration, il contrôle aussi le plan de contrôle :

View file

@ -14,6 +14,18 @@
quand ses VM sont en `deleting`, et attend leur suppression jusqu'à `timeout_subnet_stop`. Le 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` 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-<id>-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 ## Correctifs
- **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait - **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 ## 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 - **`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 `vxlan` reçoit désormais un 400. Les subnets existants gardent la route par défaut qu'ils
annonçaient jusqu'à leur recréation annonçaient jusqu'à leur recréation