From 6bf0435ea4bb5f5db4662c2e06ce4561b7a8429f Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Sun, 4 Oct 2026 17:44:40 +0200 Subject: [PATCH] =?UTF-8?q?f-50:=20docs:=20sch=C3=A9ma=20d'architecture=20?= =?UTF-8?q?du=20cluster=20=E2=80=94=20routeurs,=20route=20reflector,=20hyp?= =?UTF-8?q?erviseurs,=20plans=20de=20donn=C3=A9es=20et=20de=20contr=C3=B4l?= =?UTF-8?q?e=20#50?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- docs/deploiement/architecture-cluster.rst | 14 +- docs/schemas/architecture-cluster-dark.svg | 154 +++++++++++++++++++++ docs/schemas/architecture-cluster.svg | 154 +++++++++++++++++++++ docs/schemas/topologie-cluster-dark.svg | 52 ------- docs/schemas/topologie-cluster.svg | 52 ------- 5 files changed, 316 insertions(+), 110 deletions(-) create mode 100644 docs/schemas/architecture-cluster-dark.svg create mode 100644 docs/schemas/architecture-cluster.svg delete mode 100644 docs/schemas/topologie-cluster-dark.svg delete mode 100644 docs/schemas/topologie-cluster.svg diff --git a/docs/deploiement/architecture-cluster.rst b/docs/deploiement/architecture-cluster.rst index d1eb9bf..3956bab 100644 --- a/docs/deploiement/architecture-cluster.rst +++ b/docs/deploiement/architecture-cluster.rst @@ -4,21 +4,23 @@ Architecture du cluster Topologie --------- -.. figure:: /schemas/topologie-cluster.svg - :alt: Topologie du cluster : routeurs, route reflector et hyperviseurs +.. figure:: /schemas/architecture-cluster.svg + :alt: Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle :align: center :width: 100% :class: only-light - Topologie cible. Trait plein : plan de données. Trait pointillé : plan de contrôle. + Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle + (sessions BGP). Pointillé gris : interfaces créées par l'agent. -.. figure:: /schemas/topologie-cluster-dark.svg - :alt: Topologie du cluster : routeurs, route reflector et hyperviseurs +.. figure:: /schemas/architecture-cluster-dark.svg + :alt: Architecture du cluster : routeurs, route reflector, hyperviseurs, plans de données et de contrôle :align: center :width: 100% :class: only-dark - Topologie cible. Trait plein : plan de données. Trait pointillé : plan de contrôle. + Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle + (sessions BGP). Pointillé gris : interfaces créées par l'agent. Deux plans distincts, à ne pas confondre au moment du diagnostic : diff --git a/docs/schemas/architecture-cluster-dark.svg b/docs/schemas/architecture-cluster-dark.svg new file mode 100644 index 0000000..eecea79 --- /dev/null +++ b/docs/schemas/architecture-cluster-dark.svg @@ -0,0 +1,154 @@ + + + + + + + + + + ROUTEURS DE CLUSTER · AS 65100 + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + + + VM ROUTE REFLECTOR · AS 65000 + lo1 · 10.255.255.1/32 + router-id, cluster-id, source des sessions EVPN + 169.254.0.3/28 + adresse secondaire sur son interface du segment + 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 route par défaut : 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 des hyperviseurs : celles du lab. Placement de la VM route reflector : à rédiger. + diff --git a/docs/schemas/architecture-cluster.svg b/docs/schemas/architecture-cluster.svg new file mode 100644 index 0000000..130b014 --- /dev/null +++ b/docs/schemas/architecture-cluster.svg @@ -0,0 +1,154 @@ + + + + + + + + + + ROUTEURS DE CLUSTER · AS 65100 + + routeur 1 + 169.254.0.1/28 + + routeur 2 + 169.254.0.2/28 + + + VM ROUTE REFLECTOR · AS 65000 + lo1 · 10.255.255.1/32 + router-id, cluster-id, source des sessions EVPN + 169.254.0.3/28 + adresse secondaire sur son interface du segment + 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 route par défaut : 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 des hyperviseurs : celles du lab. Placement de la VM route reflector : à rédiger. + diff --git a/docs/schemas/topologie-cluster-dark.svg b/docs/schemas/topologie-cluster-dark.svg deleted file mode 100644 index 48a3916..0000000 --- a/docs/schemas/topologie-cluster-dark.svg +++ /dev/null @@ -1,52 +0,0 @@ - - - - - ROUTEURS DE CLUSTER - - routeur A - - routeur B - - - VM route reflector - plan de contrôle - - - HYPERVISEUR 1 - - br-000000 - - FRR - - agent - - - - - HYPERVISEUR 2 - - br-000000 - - FRR - - agent - - - - - - uplink - uplink - - - - diff --git a/docs/schemas/topologie-cluster.svg b/docs/schemas/topologie-cluster.svg deleted file mode 100644 index 858d18a..0000000 --- a/docs/schemas/topologie-cluster.svg +++ /dev/null @@ -1,52 +0,0 @@ - - - - - ROUTEURS DE CLUSTER - - routeur A - - routeur B - - - VM route reflector - plan de contrôle - - - HYPERVISEUR 1 - - br-000000 - - FRR - - agent - - - - - HYPERVISEUR 2 - - br-000000 - - FRR - - agent - - - - - - uplink - uplink - - - -