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 1e6424c6e1
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
6 changed files with 64 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é
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.
À la création, l'agent relie le netns au **bridge 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). 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 ``<VTEP>:<l3vni>`` 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
``<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>`` :

View file

@ -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>``
- 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>``
- VNI du segment public, partagé avec les bordures (``vxlan-public``)
- ``1``
* - ``-R <secondes>``
- 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-<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.
**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-<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::

View file

@ -30,8 +30,9 @@ encore est décrit sur son ticket :
* **Internet** (`#31 <https://git.g3e.fr/syonad/two/issues/31>`_,
`#42 <https://git.g3e.fr/syonad/two/issues/42>`_). Les bordures partagent avec les hyperviseurs
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.

View file

@ -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-<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
---

View file

@ -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 :

View file

@ -28,6 +28,18 @@
- Les règles sont posées avant la création du tap et retirées après sa suppression ; le watchdog
signale une interface d'une VM `running` dont les règles manquent ou ont été modifiées
**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
- **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait
@ -62,6 +74,14 @@
- **Une VM ne peut plus émettre depuis une adresse qui n'est pas la sienne (#76)** : une VM qui
route pour d'autres machines, porte une adresse supplémentaire ou sert le DHCP perd ce trafic.
Pour un serveur DHCP, créer l'interface avec `dhcp_server: true`
- **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