f-57: doc: gateway anycast (modes réseau, invariants, diagnostic), contrat d'API et notes de version 0.2.0 #57

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-16 10:44:45 +02:00
commit 2ce5024d91
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
6 changed files with 183 additions and 38 deletions

View file

@ -58,12 +58,25 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
- Le démarrage échoue si la section est incomplète, si FRR tourne déjà sous un autre AS ou si
`vtysh` ne répond pas
**Gateway des subnets `vxlan`**
**Gateway anycast des subnets `vxlan` (#57)**
- Le bridge du subnet porte une **MAC propre à l'hôte**, `02:03:<IPv4 du VTEP>`, posée à la
création du subnet. Une MAC identique sur tous les hôtes (anycast) a été essayée puis retirée :
annoncée en double en EVPN, elle empêchait aussi une gateway de joindre en L2 une VM d'un autre
hôte (#57)
- La gateway et l'adresse d'émission sont **calculées** par l'agent : avant-dernière adresse du
`cidr` (`.254` en `/24`) pour la gateway, exposée comme `interface_ip`, et celle d'avant
(`.253`) pour l'adresse d'émission, exposée comme nouveau champ `relay_ip`. Le `cidr` doit
être sans bits d'hôte et faire au plus `/29`
- La gateway est portée par un macvlan `gw-<subnet>` à **MAC anycast** `02:01:00:<VNI sur 24 bits>`,
identique sur tous les hôtes qui portent le subnet : une VM résout toujours sa gateway vers son
hôte. Le bridge garde une MAC propre à l'hôte, `02:03:<IPv4 du VTEP>`, et porte l'adresse
d'émission, d'où partent les requêtes ARP du netns
- Une VM qui reçoit la requête ARP d'un autre hôte ne change plus de gateway : jusqu'ici, elle
envoyait pendant quelques secondes son trafic à cet hôte, coupant métadonnées, renouvellement
DHCP et sessions depuis le netns. Mesuré en lab : aucune perte pendant cette fenêtre
- La MAC anycast est confinée au netns — règles ebtables sur le veth du subnet et entrée FDB
locale dans le bridge — et n'apparaît jamais en EVPN. Le DHCP écoute sur `gw-<subnet>` ; la
route du subnet a la gateway pour source
- Une VM ne peut prendre ni la gateway, ni l'adresse d'émission, ni la `gateway` explicite, ni
l'adresse de réseau ou de broadcast du subnet, ni une adresse hors de son `cidr` (422)
- Le watchdog contrôle le macvlan, sa MAC, les deux adresses et l'entrée FDB
**Exploitation**
@ -109,9 +122,8 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
Celles de la 0.1.0 restent valables, sauf mention contraire ci-dessus. S'y ajoutent :
- **L3VNI** : pas de migration à chaud ; le cache ARP d'une VM qui changerait d'hôte reste à
traiter (#57). MTU 1500 de bout en bout (#56). Un seul route reflector qualifié (#54). Le
transit `169.254.0.0/30` étant identique sur tous les hôtes, les ICMP des sauts distants sont
- **L3VNI** : pas de migration à chaud ; la gateway anycast (#57) la prépare côté réseau. MTU
1500 de bout en bout (#56). Le transit `169.254.0.0/30` étant identique sur tous les hôtes, les ICMP des sauts distants sont
rejetés comme « martiens » (traceroute partiel)
- Avec une section `bgp`, l'agent ne démarre pas sans FRR et `agent.service` ne le relance pas :
au démarrage, l'ordre est migration réseau, puis FRR, puis l'agent (#52)
@ -136,10 +148,16 @@ curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
bash ./deploy.sh -t 0.2.0
```
Aucune action n'est requise : sans `dhcp.backend` ni `bgp` dans `/etc/two/agent.yml`, le
comportement est celui de la 0.1.0, à une exception près — **un subnet encore utilisé par une VM
ne se supprime plus** : supprimer les VM d'abord. Les subnets `vxlan` existants gardent leur MAC
de gateway jusqu'à leur recréation.
Sans `dhcp.backend` ni `bgp` dans `/etc/two/agent.yml`, le comportement est celui de la 0.1.0, à
deux exceptions près, qui touchent les appelants de l'API :
- **`interface_ip` ne se fournit plus pour un subnet `vxlan`** : il est refusé (400), l'agent le
calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières
adresses utilisables du subnet. Il reste obligatoire en `bridge` et `public_ip`
- **un subnet encore utilisé par une VM ne se supprime plus** : supprimer les VM d'abord
Les subnets `vxlan` existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu'à leur recréation.
Pour router entre hyperviseurs : ajouter la section `bgp`, réduire `frr.conf` à `hostname` et
`log` (l'agent pose le reste), puis créer les VPC avec `l3vni`. Pour passer au serveur intégré, suivre la procédure de bascule dans la