Elle paraît redondante avec la route par défaut. Elle ne l’est pas.
graph TD
- VPC["VPC<br/><i>network namespace</i><br/>cidr"] --> SN1["Subnet<br/><i>bridge + VXLAN</i><br/>interface_ip, cidr"]
+ VPC["VPC<br/><i>network namespace</i><br/>cidr"] --> SN1["Subnet<br/><i>bridge + VXLAN</i><br/>cidr, gateway"]
VPC --> SN2["Subnet"]
SN1 --> VM1["VM<br/><i>QEMU/KVM</i>"]
SN1 --> VM2["VM"]
@@ -843,8 +843,9 @@ configurée fait planter
Subnet
-Un subnet appartient à un VPC et pose, dans son netns, un bridge qui porte interface_ip — la
-gateway vue par les VM. Il fournit aussi le DHCP — dnsmasq ou le serveur intégré selon
+
Un subnet appartient à un VPC et pose, dans son netns, un bridge et la gateway vue par les VM,
+interface_ip — calculée par l’agent et portée par un macvlan à MAC anycast en mode vxlan ,
+fournie par l’appelant et portée par le bridge dans les autres modes. Il fournit aussi le DHCP — dnsmasq ou le serveur intégré selon
dhcp.backend — et les routes annoncées aux guests.
iface_type est une clé logique (vms , internet , admin …), traduite en nom de
bridge physique par la configuration de l’agent. Une clé absente ou inconnue retombe sur
diff --git a/main/demarrage/premier-vpc.html b/main/demarrage/premier-vpc.html
index fd6fe9c..edb38d5 100644
--- a/main/demarrage/premier-vpc.html
+++ b/main/demarrage/premier-vpc.html
@@ -806,7 +806,7 @@ plan de contrôle du cluster en place, cf.
graph LR
subgraph netns vp-admin
- BR["br-sn000001<br/>10.1.1.1"]
+ BR["br-sn000001<br/>10.1.1.254"]
MD["metadata@i-web<br/>169.254.169.254"]
end
VM["VM i-web<br/>10.1.1.2"] --- BR
@@ -841,14 +841,18 @@ prêt est refusé en 422 . Le modèle d’attente est décrit da
"mode": "vxlan",
"vxlan_id": 1,
"iface_type": "vms",
- "interface_ip": "10.1.1.1",
"cidr": "10.1.0.0/23"}'
iface_type est une clé logique résolue dans la configuration de l’agent (section
interfaces ) vers un bridge physique de l’host ; une clé inconnue retombe sur
-default_interface . interface_ip est la gateway du subnet, portée par le bridge créé dans
-le netns.
+default_interface .
+En mode vxlan , les adresses de la gateway sont calculées et ne se fournissent pas (un
+interface_ip est refusé) : la gateway vue par les VM est l’avant-dernière adresse du CIDR
+(interface_ip = 10.1.1.254 ici), l’adresse d’émission propre au netns la précédente
+(relay_ip = 10.1.1.253 ) ; le CIDR doit valoir au plus /29 . Aucune VM ne peut prendre
+ces deux adresses, ni celles du réseau et du broadcast. En mode bridge , interface_ip reste
+obligatoire.
Les modes disponibles et leurs conséquences sur le routage sont détaillés dans
Modes réseau .
Là encore, attendez running :
diff --git a/main/developpement/lab.html b/main/developpement/lab.html
index 6f3bcb2..43096a3 100644
--- a/main/developpement/lab.html
+++ b/main/developpement/lab.html
@@ -662,13 +662,15 @@ sortie vaut 1 si une vérification échoue ou si aucune n’a été fait
backend DHCP two , une VPC et deux subnets : chaque VM reçoit l’adresse de son
subnet, démarrée seule ou en même temps qu’une autre ; le bail est tenu par
systemd-networkd ; route par défaut, route vers la VPC et /32 vers les métadonnées
-via interface_ip ; l’état de chaque serveur DHCP ne connaît que les MAC de son subnet
-(#46)
+via la gateway calculée (.254 ) ; l’état de chaque serveur DHCP ne connaît que les MAC de
+son subnet (#46)
hv1
s2-gateway
-route par défaut via interface_ip , ou via gateway avec default_route ; route
-vers la VPC toujours via interface_ip ; même résultat après recréation du subnet (#31)
+gateway (.254 ) et adresse d’émission (.253 ) calculées par l’agent, refusées pour
+une VM ; interface_ip refusé sur un subnet vxlan (#57) ; route par défaut via la
+gateway, ou via gateway avec default_route ; route vers la VPC toujours via la
+gateway du subnet ; macvlan retiré à la suppression, même résultat après recréation (#31)
hv1
s3-isolation-local
@@ -709,16 +711,17 @@ bgpd
suite de s7 , topologie evpn-3hv.yml : migration d’une VM de hv1 vers hv2 par l’API,
observée depuis hv3 qui n’a pas le subnet : migration simple (VM supprimée puis recréée,
/24 comme filet), séquence orchestrée (deux VM de même IP, deux /32 en ECMP, 40
-sources sur 40) ; l’ancien « pire cas » devient un refus (409) ; MAC de gateway propre à
-chaque hôte, sans doublon EVPN ; watchdog : /32 orphelin signalé comme trou noir, /32 manquant
+sources sur 40) ; l’ancien « pire cas » devient un refus (409) ; MAC anycast de la gateway
+absente d’EVPN (aucune route de type 2 sur rr1, absente de la table de hv1), sans doublon
+(#57) ; watchdog : /32 orphelin signalé comme trou noir, /32 manquant
signalé
hv1, hv2, hv3, rr1
s9-subnets-partages
deux VPC, avec et sans l3vni , chacune avec deux subnets présents sur les deux
hyperviseurs et une VM par subnet et par hôte : ping entre toutes les paires (même subnet ou
-non, même hôte ou non) ; chaque VM voit la MAC de gateway de son propre hôte ; aucune MAC en
-double sur les quatre VNI
+non, même hôte ou non) ; chaque VM voit la MAC anycast de sa gateway ; aucune MAC en
+double et aucune MAC anycast dans EVPN sur les quatre VNI (#57)
hv2, hv3, rr1
s10-switch-loss
@@ -730,6 +733,15 @@ silence sous 5 s ; interface rétablie : ses sessions eBGP reviennent et il , sans reprendre la passerelle (#54)
hv1, sw1, sw2
+s11-fenetre-arp
+fenêtre ARP de #57 : sur hv1, entrées ARP du netns retirées, puis une VM de hv1 joint une VM
+de hv2 dans l’autre subnet (relais L2 depuis l’adresse d’émission de hv1). La VM de hv2
+associe alors .253 à la MAC de hv1 (fenêtre ouverte, vérifiée), mais sa gateway reste
+la MAC anycast ; pendant la fenêtre, métadonnées servies, bail DHCP renouvelé auprès de
+.254 , et aucune des 80 connexions TCP du netns de hv2 vers sa VM n’est perdue ; MAC
+anycast inscrite dans la FDB du bridge du netns
+hv1, hv2
+
diff --git a/main/exploitation/api-agent/reference.html b/main/exploitation/api-agent/reference.html
index 4899d11..5224dca 100644
--- a/main/exploitation/api-agent/reference.html
+++ b/main/exploitation/api-agent/reference.html
@@ -735,7 +735,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
-422 Unprocessable Entity –
Subnet not found, or not in creating/running state
+422 Unprocessable Entity –
Subnet not found, or not in creating/running state; or an interface IP outside the subnet CIDR, equal to its network or broadcast address, or reserved by the subnet (interface_ip, relay_ip, gateway)
Example response:
HTTP / 1.1 422 Unprocessable Content
Content-Type : application/json
@@ -942,6 +942,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
"vxlan_id" : 1 ,
"local_iface" : "string" ,
"interface_ip" : "string" ,
+ "relay_ip" : "string" ,
"cidr" : "string" ,
"default_route" : true ,
"gateway" : "string"
@@ -1004,6 +1005,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
"vxlan_id" : 1 ,
"local_iface" : "string" ,
"interface_ip" : "string" ,
+ "relay_ip" : "string" ,
"cidr" : "string" ,
"default_route" : true ,
"gateway" : "string"
@@ -1011,7 +1013,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
-400 Bad Request –
Missing required field or unknown iface_type
+400 Bad Request –
Missing required field; interface_ip missing on a bridge or public_ip subnet, or supplied on a vxlan subnet (it is computed)
Example response:
HTTP / 1.1 400 Bad Request
Content-Type : application/json
@@ -1033,7 +1035,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
-422 Unprocessable Entity –
Parent VPC does not exist or is not ready
+422 Unprocessable Entity –
Unknown mode; parent VPC does not exist or is not ready; invalid CIDR, or a vxlan CIDR smaller than /29
Example response:
HTTP / 1.1 422 Unprocessable Content
Content-Type : application/json
@@ -1092,6 +1094,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
"vxlan_id" : 1 ,
"local_iface" : "string" ,
"interface_ip" : "string" ,
+ "relay_ip" : "string" ,
"cidr" : "string" ,
"default_route" : true ,
"gateway" : "string"
@@ -1151,6 +1154,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
"vxlan_id" : 1 ,
"local_iface" : "string" ,
"interface_ip" : "string" ,
+ "relay_ip" : "string" ,
"cidr" : "string" ,
"default_route" : true ,
"gateway" : "string"
diff --git a/main/exploitation/diagnostic.html b/main/exploitation/diagnostic.html
index 13c21fc..cecfc72 100644
--- a/main/exploitation/diagnostic.html
+++ b/main/exploitation/diagnostic.html
@@ -344,6 +344,7 @@
La ressource part en error juste après le 202
La VM démarre mais n’a pas d’adresse
+La VM ne joint pas sa gateway (subnet vxlan )
La VM a une adresse mais cloud-init n’applique rien
Le user-data est servi vide
La VM ne démarre pas (UEFI)
@@ -413,6 +414,34 @@ la MAC n’est pas réservée — l’ordre
+La VM ne joint pas sa gateway (subnet vxlan )
+La gateway d’un subnet vxlan est un macvlan gw-<subnet> à MAC anycast
+(Modes réseau ). Le watchdog contrôle sa présence, sa MAC, les adresses et l’entrée
+FDB : ses notifications (interface gw-… , lacks the gateway address , no local fdb
+entry …) disent déjà ce qui manque. À la main, dans le netns du VPC :
+# macvlan actif, MAC 02:01:00:<VNI>, gateway en /32 ; adresse d'émission seule sur le bridge
+ip -n <vpc> -br addr show gw-<subnet>
+ip -n <vpc> -br addr show br-<subnet>
+
+# entrée locale de la MAC anycast dans le bridge (« master br-<subnet> permanent »)
+ip netns exec <vpc> bridge fdb show br br-<subnet> | grep 02 :01:00
+
+# route du subnet émise depuis la gateway
+ip -n <vpc> -4 route show dev br-<subnet>
+
+# confinement : source anycast rejetée sur le veth du subnet
+ip netns exec <vpc> ebtables -t nat -L PREROUTING
+ip netns exec <vpc> ebtables -L FORWARD
+
+
+Dans le guest, ip neigh show <gateway> doit montrer la MAC 02:01:00:<VNI> . Une autre MAC —
+celle d’un hôte, 02:03:… — signale un subnet de l’ancien modèle (sans relay_ip ) ou une
+gateway posée sur le bridge.
+Depuis le netns d’un hôte, une VM d’un autre hôte ne répond qu’à l’adresse d’émission :
+ip netns exec <vpc> ping -I <relay_ip> <ip> . Un ping sans -I part de la gateway et la
+réponse revient à l’hôte de la VM — ce n’est pas une panne.
+
La VM a une adresse mais cloud-init n’applique rien
Deux causes distinctes, à écarter dans cet ordre.
@@ -531,6 +560,7 @@ l’agent n’est plus piloté par lui.
-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
@@ -473,9 +486,8 @@ d’état, dans un
Périmètre et limites connues
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)
@@ -500,10 +512,16 @@ le dialogue avec le serveur intégré, est couvert sur toute plateforme
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
documentation d’exploitation — elle suppose un hyperviseur vidé.