From 9d3395bae1390858de5af4abc4c9f91689f2c291 Mon Sep 17 00:00:00 2001 From: forgejo-actions Date: Sat, 17 Oct 2026 22:48:45 +0000 Subject: [PATCH] docs: build de 02d147d4abeb2c235829035cac04db3f835ddcdd --- main/_images/architecture-cluster-dark.svg | 279 +++++------ main/_images/architecture-cluster.svg | 279 +++++------ main/_images/architecture-ensemble-dark.svg | 185 ++++++++ main/_images/architecture-ensemble.svg | 185 ++++++++ main/concepts/modes-reseau.html | 2 +- main/deploiement/architecture-cluster.html | 65 ++- main/developpement/lab.html | 487 +++++++++++++------- main/searchindex.js | 2 +- 8 files changed, 1051 insertions(+), 433 deletions(-) create mode 100644 main/_images/architecture-ensemble-dark.svg create mode 100644 main/_images/architecture-ensemble.svg diff --git a/main/_images/architecture-cluster-dark.svg b/main/_images/architecture-cluster-dark.svg index 8128137..5bcb248 100644 --- a/main/_images/architecture-cluster-dark.svg +++ b/main/_images/architecture-cluster-dark.svg @@ -1,155 +1,170 @@ - + + + - - - ROUTEURS DE CLUSTER · AS 65100 - - routeur 1 - 169.254.0.1/28 - - routeur 2 - 169.254.0.2/28 - passerelle 192.168.14.1/24 - - - VM ROUTE REFLECTOR · AS 65000 - lo1 · 10.255.255.1/32 - router-id, cluster-id, source des sessions EVPN - 192.168.14.4/24 · 169.254.0.3/28 - principale, et secondaire pour le lien avec les routeurs - hébergée par le cluster lui-même - - - eBGP · BFD (×2) - annonce lo1 seule - n'accepte rien - - - - - - - - segment underlay · L2 - 192.168.14.0/24 · 169.254.0.0/28 - - - HYPERVISEUR 1 - - - br-000000 - uplink · 192.168.14.11 - - vxlan-<vni> - dans br-<subnet>, sans learning - - netns du VPC - passerelle, DHCP - - VM - QEMU / KVM - - VTEP - - veth - - tap - - - FRR - bgpd · AS 64600 - advertise-all-vni - - agent - API REST · Badger - - - FDB - - crée - - - HYPERVISEUR 2 - - - br-000000 - uplink · 192.168.14.12 - - vxlan-<vni> - dans br-<subnet>, sans learning - - netns du VPC - passerelle, DHCP - - VM - QEMU / KVM - - VTEP - - veth - - tap - - - FRR - bgpd · AS 64600 - advertise-all-vni - - agent - API REST · Badger - - - FDB - - crée - - - - - - - - iBGP l2vpn evpn · AS 64600 - iBGP - - - VXLAN - UDP 4789 - - - lien L2 / interface - - plan de données : tunnels VXLAN - - plan de contrôle : sessions BGP - - créé par l'agent - - Les hyperviseurs joignent 10.255.255.1 par leur passerelle 192.168.14.1 : les routeurs l'ont apprise du route reflector en eBGP, sans rien lui renvoyer. - Le route reflector accepte toute session venant de 192.168.14.0/24 (bgp listen range) et réfléchit les routes EVPN entre hyperviseurs. - Chaque FRR en peuple la FDB des VXLAN locaux — intégration de FRR avec les interfaces créées par two : à qualifier (#50, E5). - MTU du segment : 1550 au moins (VXLAN figé à 1500 par l'agent, + 50 octets d'encapsulation) ; 9000 dans le lab. - ASN, loopback et plages : valeurs de production (#50). Adresses en 192.168.14.0/24 : celles du lab. Placement de la VM route reflector : à rédiger. + + ROUTEURS DU CLUSTER · AS 65100 + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + passerelle de l'underlay en VRRP + annoncent les loopbacks des RR, ne leur renvoient rien + + ROUTE REFLECTORS · AS 65000 + + route reflector 1 + lo 10.255.255.1/32 · 169.254.0.3/28 + + route reflector 2 + lo 10.255.255.2/32 · 169.254.0.4/28 + router-id, cluster-id et source des sessions EVPN : la loopback + un par cluster (vue d'ensemble) ; le lab les réunit dans un seul + + eBGP · BFD + loopbacks seules + + segment underlay · L2 · lien routeurs ↔ RR en 169.254.0.0/28 + + + + VXLAN · UDP 4789 · de VTEP à VTEP + + + + HYPERVISEUR 1 + + br-000000 + IP de l'hyperviseur = VTEP + + FRR + bgpd · AS 64600 + advertise-all-vni + + agent + API REST · Badger + + vxlan-<vni> + dans br-<subnet>, sans learning + + NETNS DE LA VPC + + gw-<subnet> + gateway .254 + MAC anycast + + DHCP + métadonnées + écoutent sur gw- + + br-<subnet> + adresse d'émission .253 + + VM + QEMU / KVM · tap dans le netns + macvlan gw- posé sur br-, confiné à l'hôte (#57) + + vrf-<vpc> · L3VNI + brl3 · vxl3 · veth de transit + routage entre hyperviseurs (#41) + + + + tap + + transit + + + + + + HYPERVISEUR 2 + + br-000000 + IP de l'hyperviseur = VTEP + + FRR + bgpd · AS 64600 + advertise-all-vni + + agent + API REST · Badger + + vxlan-<vni> + dans br-<subnet>, sans learning + + NETNS DE LA VPC + + gw-<subnet> + gateway .254 + MAC anycast + + DHCP + métadonnées + écoutent sur gw- + + br-<subnet> + adresse d'émission .253 + + VM + QEMU / KVM · tap dans le netns + macvlan gw- posé sur br-, confiné à l'hôte (#57) + + vrf-<vpc> · L3VNI + brl3 · vxl3 · veth de transit + routage entre hyperviseurs (#41) + + + + tap + + transit + + + + + iBGP l2vpn evpn · AS 64600 (FRR → RR) + + lien L2 / interface + + plan de données : tunnels VXLAN + + plan de contrôle : sessions BGP + + créé par l'agent + Les hyperviseurs joignent les loopbacks des route reflectors par leur passerelle : les routeurs les ont apprises en eBGP, sans rien leur renvoyer. + Les route reflectors acceptent toute session venant de l'underlay (bgp listen range) et réfléchissent les routes EVPN entre hyperviseurs ; chaque FRR en peuple la FDB des VXLAN locaux. + La gateway d'un subnet a la même IP et la même MAC sur tous les hôtes ; chaque netns émet depuis son adresse d'émission. Les subnets d'une VPC se joignent par son L3VNI. + ASN et loopbacks : valeurs de production (#50). Vue d'ensemble (bordures, Internet, orchestration, plusieurs clusters) : schéma précédent. diff --git a/main/_images/architecture-cluster.svg b/main/_images/architecture-cluster.svg index 1770e12..353e7f0 100644 --- a/main/_images/architecture-cluster.svg +++ b/main/_images/architecture-cluster.svg @@ -1,155 +1,170 @@ - + + + - - - ROUTEURS DE CLUSTER · AS 65100 - - routeur 1 - 169.254.0.1/28 - - routeur 2 - 169.254.0.2/28 - passerelle 192.168.14.1/24 - - - VM ROUTE REFLECTOR · AS 65000 - lo1 · 10.255.255.1/32 - router-id, cluster-id, source des sessions EVPN - 192.168.14.4/24 · 169.254.0.3/28 - principale, et secondaire pour le lien avec les routeurs - hébergée par le cluster lui-même - - - eBGP · BFD (×2) - annonce lo1 seule - n'accepte rien - - - - - - - - segment underlay · L2 - 192.168.14.0/24 · 169.254.0.0/28 - - - HYPERVISEUR 1 - - - br-000000 - uplink · 192.168.14.11 - - vxlan-<vni> - dans br-<subnet>, sans learning - - netns du VPC - passerelle, DHCP - - VM - QEMU / KVM - - VTEP - - veth - - tap - - - FRR - bgpd · AS 64600 - advertise-all-vni - - agent - API REST · Badger - - - FDB - - crée - - - HYPERVISEUR 2 - - - br-000000 - uplink · 192.168.14.12 - - vxlan-<vni> - dans br-<subnet>, sans learning - - netns du VPC - passerelle, DHCP - - VM - QEMU / KVM - - VTEP - - veth - - tap - - - FRR - bgpd · AS 64600 - advertise-all-vni - - agent - API REST · Badger - - - FDB - - crée - - - - - - - - iBGP l2vpn evpn · AS 64600 - iBGP - - - VXLAN - UDP 4789 - - - lien L2 / interface - - plan de données : tunnels VXLAN - - plan de contrôle : sessions BGP - - créé par l'agent - - Les hyperviseurs joignent 10.255.255.1 par leur passerelle 192.168.14.1 : les routeurs l'ont apprise du route reflector en eBGP, sans rien lui renvoyer. - Le route reflector accepte toute session venant de 192.168.14.0/24 (bgp listen range) et réfléchit les routes EVPN entre hyperviseurs. - Chaque FRR en peuple la FDB des VXLAN locaux — intégration de FRR avec les interfaces créées par two : à qualifier (#50, E5). - MTU du segment : 1550 au moins (VXLAN figé à 1500 par l'agent, + 50 octets d'encapsulation) ; 9000 dans le lab. - ASN, loopback et plages : valeurs de production (#50). Adresses en 192.168.14.0/24 : celles du lab. Placement de la VM route reflector : à rédiger. + + ROUTEURS DU CLUSTER · AS 65100 + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + passerelle de l'underlay en VRRP + annoncent les loopbacks des RR, ne leur renvoient rien + + ROUTE REFLECTORS · AS 65000 + + route reflector 1 + lo 10.255.255.1/32 · 169.254.0.3/28 + + route reflector 2 + lo 10.255.255.2/32 · 169.254.0.4/28 + router-id, cluster-id et source des sessions EVPN : la loopback + un par cluster (vue d'ensemble) ; le lab les réunit dans un seul + + eBGP · BFD + loopbacks seules + + segment underlay · L2 · lien routeurs ↔ RR en 169.254.0.0/28 + + + + VXLAN · UDP 4789 · de VTEP à VTEP + + + + HYPERVISEUR 1 + + br-000000 + IP de l'hyperviseur = VTEP + + FRR + bgpd · AS 64600 + advertise-all-vni + + agent + API REST · Badger + + vxlan-<vni> + dans br-<subnet>, sans learning + + NETNS DE LA VPC + + gw-<subnet> + gateway .254 + MAC anycast + + DHCP + métadonnées + écoutent sur gw- + + br-<subnet> + adresse d'émission .253 + + VM + QEMU / KVM · tap dans le netns + macvlan gw- posé sur br-, confiné à l'hôte (#57) + + vrf-<vpc> · L3VNI + brl3 · vxl3 · veth de transit + routage entre hyperviseurs (#41) + + + + tap + + transit + + + + + + HYPERVISEUR 2 + + br-000000 + IP de l'hyperviseur = VTEP + + FRR + bgpd · AS 64600 + advertise-all-vni + + agent + API REST · Badger + + vxlan-<vni> + dans br-<subnet>, sans learning + + NETNS DE LA VPC + + gw-<subnet> + gateway .254 + MAC anycast + + DHCP + métadonnées + écoutent sur gw- + + br-<subnet> + adresse d'émission .253 + + VM + QEMU / KVM · tap dans le netns + macvlan gw- posé sur br-, confiné à l'hôte (#57) + + vrf-<vpc> · L3VNI + brl3 · vxl3 · veth de transit + routage entre hyperviseurs (#41) + + + + tap + + transit + + + + + iBGP l2vpn evpn · AS 64600 (FRR → RR) + + lien L2 / interface + + plan de données : tunnels VXLAN + + plan de contrôle : sessions BGP + + créé par l'agent + Les hyperviseurs joignent les loopbacks des route reflectors par leur passerelle : les routeurs les ont apprises en eBGP, sans rien leur renvoyer. + Les route reflectors acceptent toute session venant de l'underlay (bgp listen range) et réfléchissent les routes EVPN entre hyperviseurs ; chaque FRR en peuple la FDB des VXLAN locaux. + La gateway d'un subnet a la même IP et la même MAC sur tous les hôtes ; chaque netns émet depuis son adresse d'émission. Les subnets d'une VPC se joignent par son L3VNI. + ASN et loopbacks : valeurs de production (#50). Vue d'ensemble (bordures, Internet, orchestration, plusieurs clusters) : schéma précédent. diff --git a/main/_images/architecture-ensemble-dark.svg b/main/_images/architecture-ensemble-dark.svg new file mode 100644 index 0000000..e2b5f6a --- /dev/null +++ b/main/_images/architecture-ensemble-dark.svg @@ -0,0 +1,185 @@ + + + + + + + + + + Internet + + agrégats publics + + BORDURES · AS PUBLIC · #31 + + bordure 1 + gateway anycast + + bordure 2 + gateway anycast + même IP et même MAC de gateway · sans état + VTEP · VNI 66001 (public) + + CLUSTER A + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72 + + CLUSTER B + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + VRRP · VTEP · VNI 66000 + NAT vers le VNI 66000 · #72 + + underlay B · VXLAN UDP 4789 · BGP + + + + route reflector 2 + lo 10.255.255.2/32 · 169.254.0.4/28 + + iBGP EVPN + + HYPERVISEURS B (×N) + + hyperviseur B1 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + + hyperviseur B2 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + + hyperviseur B3 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + … + même modèle que + l'hyperviseur détaillé + + + eBGP · routeur 2 de A → routeur 1 de B + + + eBGP + eBGP + + underlay A · VXLAN UDP 4789 · BGP + + + + route reflector 1 + lo 10.255.255.1/32 · 169.254.0.3/28 + + iBGP EVPN + + SERVICES · VNI 66000 PARTAGÉ ENTRE CLUSTERS · #72 + + broker + MQTT · VNI 66000 + + orchestrateur + VNI 66000 et VNI 66001 + + + + + HYPERVISEUR A (détaillé) + + br-000000 + IP de l'hyperviseur = VTEP + + FRR · bgpd + sessions EVPN vers les RR + + agent + API locale 127.0.0.1:8080 + client du broker, en sortie + + IP flottante · NAT 1:1 + hôte de la VM, sans état · #31 + + subnet public de l'hôte + VNI 66001 · hors VPC · #31 + + VPC · netns + VRF + + netns de la VPC + gateway .254 · DHCP · métadonnées + + VRF · L3VNI + routage entre subnets et hyperviseurs + + passerelle NAT de la VPC + sur un des hyperviseurs · #42 + + subnet public de la VPC + relié au subnet public de l'hôte + + VM privée + adresse de la VPC + + VM publique + + NIC sur le subnet public + + + + + + + + défaut type 5 + + + VNI 66001 + + + register · ordres · événements (mTLS, sortant) + + plan de données : VXLAN + + plan de contrôle : BGP + + orchestration + + trafic Internet + + à venir (ticket indiqué) + Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000. + L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures. + VM publique : un subnet public dans sa VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures. + VM privée : route par défaut de type 5 vers la passerelle NAT de sa VPC (IP de sortie de la VPC) si la VPC autorise Internet, ou IP flottante 1:1 sur son hôte. + Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster. + Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster. + diff --git a/main/_images/architecture-ensemble.svg b/main/_images/architecture-ensemble.svg new file mode 100644 index 0000000..8d86609 --- /dev/null +++ b/main/_images/architecture-ensemble.svg @@ -0,0 +1,185 @@ + + + + + + + + + + Internet + + agrégats publics + + BORDURES · AS PUBLIC · #31 + + bordure 1 + gateway anycast + + bordure 2 + gateway anycast + même IP et même MAC de gateway · sans état + VTEP · VNI 66001 (public) + + CLUSTER A + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + VRRP · VTEP · VNI 66000 · NAT vers le VNI 66000 · #72 + + CLUSTER B + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + VRRP · VTEP · VNI 66000 + NAT vers le VNI 66000 · #72 + + underlay B · VXLAN UDP 4789 · BGP + + + + route reflector 2 + lo 10.255.255.2/32 · 169.254.0.4/28 + + iBGP EVPN + + HYPERVISEURS B (×N) + + hyperviseur B1 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + + hyperviseur B2 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + + hyperviseur B3 + agent · FRR · VPC + VTEP : son IP sur l'underlay B + … + même modèle que + l'hyperviseur détaillé + + + eBGP · routeur 2 de A → routeur 1 de B + + + eBGP + eBGP + + underlay A · VXLAN UDP 4789 · BGP + + + + route reflector 1 + lo 10.255.255.1/32 · 169.254.0.3/28 + + iBGP EVPN + + SERVICES · VNI 66000 PARTAGÉ ENTRE CLUSTERS · #72 + + broker + MQTT · VNI 66000 + + orchestrateur + VNI 66000 et VNI 66001 + + + + + HYPERVISEUR A (détaillé) + + br-000000 + IP de l'hyperviseur = VTEP + + FRR · bgpd + sessions EVPN vers les RR + + agent + API locale 127.0.0.1:8080 + client du broker, en sortie + + IP flottante · NAT 1:1 + hôte de la VM, sans état · #31 + + subnet public de l'hôte + VNI 66001 · hors VPC · #31 + + VPC · netns + VRF + + netns de la VPC + gateway .254 · DHCP · métadonnées + + VRF · L3VNI + routage entre subnets et hyperviseurs + + passerelle NAT de la VPC + sur un des hyperviseurs · #42 + + subnet public de la VPC + relié au subnet public de l'hôte + + VM privée + adresse de la VPC + + VM publique + + NIC sur le subnet public + + + + + + + + défaut type 5 + + + VNI 66001 + + + register · ordres · événements (mTLS, sortant) + + plan de données : VXLAN + + plan de contrôle : BGP + + orchestration + + trafic Internet + + à venir (ticket indiqué) + Les agents ne sont jamais joints par l'orchestrateur : ils se connectent au broker en sortie, via leur passerelle ; les routeurs de leur cluster les NAT vers le VNI 66000. + L'orchestrateur a une patte dans le VNI 66001 : son API est joignable depuis Internet, par les bordures. + VM publique : un subnet public dans sa VPC, relié au subnet public de l'hôte (VNI 66001), dont la gateway anycast est portée par toutes les bordures. + VM privée : route par défaut de type 5 vers la passerelle NAT de sa VPC (IP de sortie de la VPC) si la VPC autorise Internet, ou IP flottante 1:1 sur son hôte. + Les bordures restent sans état : tout NAT vit sur un hyperviseur. Broker et orchestrateur sont des VM du VNI 66000, partagé : elles tournent sur les hyperviseurs de n'importe quel cluster. + Un route reflector par cluster : un événement d'un cluster ne coupe pas les deux sessions. Chaque lien routeurs ↔ RR est en 169.254.0.0/28, propre à son cluster. + diff --git a/main/concepts/modes-reseau.html b/main/concepts/modes-reseau.html index e4f7441..35389ee 100644 --- a/main/concepts/modes-reseau.html +++ b/main/concepts/modes-reseau.html @@ -885,7 +885,7 @@ un renouvellement unicast reste servi par l’hôte de la VM.

L’adresse d’émission est la même sur tous les hôtes : une VM qui reçoit la requête ARP d’un autre hôte associe .253 à la MAC de celui-ci. C’est sans effet — la VM ne parle jamais d’elle-même à -.253 et le netns lui parle depuis la gateway. Mesuré en lab (s11-fenetre-arp) : pendant +.253 et le netns lui parle depuis la gateway. Mesuré en lab (44-fenetre-arp) : pendant cette fenêtre, métadonnées, renouvellement DHCP et connexions depuis le netns passent sans perte.

Note

diff --git a/main/deploiement/architecture-cluster.html b/main/deploiement/architecture-cluster.html index 4d393a3..97e4619 100644 --- a/main/deploiement/architecture-cluster.html +++ b/main/deploiement/architecture-cluster.html @@ -342,6 +342,7 @@