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:
parent
461266d1d4
commit
7d79ba1a5e
6 changed files with 63 additions and 21 deletions
|
|
@ -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>`` :
|
||||
|
||||
|
|
|
|||
|
|
@ -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::
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -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 :
|
||||
|
||||
|
|
|
|||
|
|
@ -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-<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
|
||||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue