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:
parent
7ac57611bb
commit
2ce5024d91
6 changed files with 183 additions and 38 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue