diff --git a/docs/deploiement/architecture-cluster.rst b/docs/deploiement/architecture-cluster.rst index 3956bab..8501f7c 100644 --- a/docs/deploiement/architecture-cluster.rst +++ b/docs/deploiement/architecture-cluster.rst @@ -1,6 +1,56 @@ Architecture du cluster ======================= +Vue d'ensemble +-------------- + +.. figure:: /schemas/architecture-ensemble.svg + :alt: Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs + :align: center + :width: 100% + :class: only-light + + Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle + (BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés : + élément à venir, avec son ticket. + +.. figure:: /schemas/architecture-ensemble-dark.svg + :alt: Vue d'ensemble : Internet, bordures, deux clusters, route reflectors, services partagés et hyperviseurs + :align: center + :width: 100% + :class: only-dark + + Architecture cible. Trait bleu : plan de données (VXLAN). Tirets violets : plan de contrôle + (BGP). Tirets verts : orchestration. Trait orange : trafic Internet. Cadre en pointillés : + élément à venir, avec son ticket. + +Plusieurs clusters, chacun avec son underlay, ses deux routeurs et un route reflector, sont reliés +en eBGP entre eux et aux **routeurs de bordure**. Ce qui n'existe pas encore est décrit sur son +ticket : + +* **Internet** (`#31 `_, + `#42 `_). Les bordures partagent avec les hyperviseurs + un VXLAN public (VNI 66001) et portent toutes la même IP et la même MAC de gateway. Elles restent + sans état : tout NAT vit sur un hyperviseur. Trois façons de sortir : + + * une VM qui porte une IP publique a une NIC sur un subnet public de sa VPC, relié au subnet + public de l'hôte ; + * une **IP flottante** est traduite 1:1, sans état, par l'hyperviseur de la VM ; + * les autres VM sortent par la **passerelle NAT de leur VPC**, que la VRF atteint par une route + par défaut de type 5, si la VPC autorise Internet. + +* **Orchestration** (`#72 `_). Le broker et + l'orchestrateur sont des VM du VNI 66000, partagé entre clusters. Les agents s'y connectent + **en sortie**, par leur passerelle ; les routeurs de chaque cluster les NAT vers le VNI 66000. + L'orchestrateur a aussi une patte dans le VNI 66001 : son API est joignable depuis Internet. + +* **Route reflectors.** Un par cluster, pour qu'un incident sur un cluster ne coupe pas les deux + sessions EVPN. Chaque lien entre routeurs et route reflector est en ``169.254.0.0/28``, propre + à son cluster. + +Le lab (:doc:`/developpement/lab`) simplifie : un seul cluster, qui porte les deux route +reflectors. + Topologie --------- diff --git a/docs/schemas/architecture-ensemble-dark.svg b/docs/schemas/architecture-ensemble-dark.svg new file mode 100644 index 0000000..e2b5f6a --- /dev/null +++ b/docs/schemas/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/docs/schemas/architecture-ensemble.svg b/docs/schemas/architecture-ensemble.svg new file mode 100644 index 0000000..8d86609 --- /dev/null +++ b/docs/schemas/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. +