f-80: doc: commandes, chemins et codes alignés sur le code, répertoire uefi, route reflectors, schémas régénérés #80

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-23 13:48:15 +02:00
commit 9a3345f258
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
30 changed files with 271 additions and 190 deletions

View file

@ -24,9 +24,9 @@ Vue d'ensemble
(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 :
Plusieurs clusters, chacun avec son underlay et ses deux routeurs, sont reliés en eBGP entre eux
et aux **routeurs de bordure** ; les route reflectors sont décrits plus bas. Ce qui n'existe pas
encore est décrit sur son ticket :
* **Internet** (`#31 <https://git.g3e.fr/syonad/two/issues/31>`_,
`#42 <https://git.g3e.fr/syonad/two/issues/42>`_). Les bordures partagent avec les hyperviseurs
@ -41,12 +41,19 @@ ticket :
* **Orchestration** (`#72 <https://git.g3e.fr/syonad/two/issues/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.
**en sortie**, par leur passerelle ; les routeurs de chaque cluster les traduisent (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.
* **Route reflectors.** Au moins un ; deux sont prévus dans l'architecture et dans les exemples
(plages d'adresses de :doc:`route-reflector`), placés ici dans deux clusters différents 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 ``bgp listen range`` de
chaque route reflector doit alors couvrir l'underlay de **tous** les clusters qu'il sert —
l'exemple ``rr1.conf`` n'accepte que ``192.168.14.0/24``.
* **ASN.** Les routeurs de deux clusters étant voisins eBGP, chaque cluster a son propre ASN de
routeurs : l'AS 65100 des exemples est la valeur d'**un** cluster.
Le lab (:doc:`/developpement/lab`) simplifie : un seul cluster, qui porte les deux route
reflectors.
@ -79,7 +86,7 @@ Plan de données
Plan de contrôle
ce qui dit à chaque hyperviseur où se trouvent les adresses MAC des autres. C'est le rôle de
FRR et du route reflector.
FRR et des route reflectors.
Ce que l'agent suppose déjà en place
------------------------------------
@ -111,8 +118,8 @@ apprentissage des adresses MAC depuis le trafic, ni voisin statique configuré.
isolé le trafic reste sur le bridge local et cette absence ne se voit pas ; elle apparaît dès
le deuxième nœud.
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et le route reflector qui
les fait converger.
C'est exactement le rôle que remplissent FRR sur chaque hyperviseur et les route reflectors qui
les font converger.
MTU
---

View file

@ -7,7 +7,7 @@ même nœud. Cette section couvre la mise en place d'un **cluster** complet, dan
Cet ordre n'est pas indifférent : chaque étape a besoin de la précédente. L'image doit exister
avant qu'on puisse démarrer quoi que ce soit ; le réseau doit être en place avant le premier
hyperviseur ; le route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
hyperviseur ; chaque route reflector est lui-même une VM, il lui faut donc un hyperviseur qui
fonctionne.
Étapes

View file

@ -62,13 +62,13 @@ L'agent en déduit la configuration ci-dessous ; le ``router-id`` est l'adresse
Avec une section ``bgp``, l'agent **refuse de démarrer** si ``vtysh`` ne répond pas, et
``agent.service`` ne le relance pas. L'ordre au démarrage est donc : migration réseau vers
``br-000000``, **puis** FRR, **puis** l'agent. FRR démarré avant la migration peut perdre la
route par défaut quand elle change d'interface, et ne plus joindre le route reflector.
route par défaut quand elle change d'interface, et ne plus joindre les route reflectors.
Ce qu'elle établit :
* **Une session par route reflector**, en iBGP dans l'AS 64600, vers sa loopback
(``10.255.255.1``, ``10.255.255.2``), jointe par la passerelle par défaut — le routeur de
cluster l'a apprise du route reflector (:doc:`routeurs`). Aucune adresse d'un autre hyperviseur n'est écrite : ajouter
cluster l'a apprise de ce route reflector (:doc:`routeurs`). Aucune adresse d'un autre hyperviseur n'est écrite : ajouter
un nœud ne touche pas la configuration des autres.
* **EVPN seulement** : l'IPv4 unicast n'est pas activé (``no bgp default ipv4-unicast``).
``advertise-all-vni`` annonce les VNI de toutes les interfaces VXLAN que FRR voit, et donc
@ -81,9 +81,9 @@ Articulation avec l'agent
Rien à configurer à la création d'un subnet : la VXLAN apparaît, FRR la voit et l'annonce, sans
action ni redémarrage. Il faut en revanche que la VXLAN porte une **adresse VTEP locale** : sans
elle, FRR voit la VNI mais n'annonce rien, et deux hyperviseurs gérés par two ne se joignent pas.
L'agent la pose à partir de la release ``0.2.0rc003``
(`#51 <https://git.g3e.fr/syonad/two/issues/51>`_) : l'adresse IPv4 primaire du ``local_iface``
du subnet.
L'agent la pose depuis la version 0.2.0 (préversions comprises à partir de ``0.2.0rc003``,
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_, fermé) : l'adresse IPv4 primaire du
``local_iface`` du subnet.
.. note::
@ -93,11 +93,10 @@ du subnet.
et configuration doivent être posés à chaque démarrage, par le bootstrap ou un mécanisme
équivalent (`#52 <https://git.g3e.fr/syonad/two/issues/52>`_) ;
* le démarrage à froid, selon que FRR démarre avant ou après l'agent ;
* les subnets ``vxlan`` créés avant ``0.2.0rc003``, dont la VXLAN n'a pas d'adresse VTEP
locale : les recréer ou poser l'adresse à chaud, à trancher dans
`#51 <https://git.g3e.fr/syonad/two/issues/51>`_ ;
* les subnets ``vxlan`` créés par une version antérieure, dont la VXLAN n'a pas d'adresse VTEP
locale : aucune migration ne la pose, il faut les recréer ;
* le cas particulier du **premier** hyperviseur, dont la session ne peut pas s'établir tant
que le route reflector n'existe pas.
qu'aucun route reflector n'existe.
Vérifier le plan de données
---------------------------

View file

@ -3,9 +3,11 @@ VM route reflector
Le route reflector est le point de rendez-vous du plan de contrôle : plutôt que de maintenir une
session entre chaque paire d'hyperviseurs, chaque hyperviseur ouvre une session vers le route
reflector, qui redistribue. Le cluster en compte **deux**, configurés à l'identique hormis leurs
adresses : chaque hyperviseur ouvre une session vers chacun, et la perte de l'un ne doit pas
interrompre le plan de contrôle (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_).
reflector, qui redistribue. Un cluster en compte **au moins un** ; l'architecture et les exemples
de cette page en prévoient **deux** (rr1 et rr2, d'où les plages d'adresses ci-dessous),
configurés à l'identique hormis leurs adresses : chaque hyperviseur ouvre une session vers chacun,
et la perte de l'un n'interrompt pas le plan de contrôle
(`#54 <https://git.g3e.fr/syonad/two/issues/54>`_, fermé).
Il tourne lui-même en machine virtuelle, ce qui crée une dépendance circulaire à traiter
explicitement : la VM qui porte le plan de contrôle du cluster est hébergée par le cluster.
@ -84,13 +86,14 @@ Ce qu'elle établit :
.. warning::
**Les tunnels ne survivent pas à la perte du route reflector.** Avec un seul route reflector
et sans ``graceful-restart``, à l'arrêt de FRR sur le route reflector, la session EVPN des
hyperviseurs tombe aussitôt, FRR retire les routes apprises et, avec elles, le VTEP distant et l'entrée d'inondation du VXLAN — **plus
aucun paquet ne passe** entre hyperviseurs, à 30 s comme à 90 s. Au redémarrage de FRR sur le
route reflector, VTEP distant et trafic reviennent **31 s** plus tard. Le trafic entre VM d'un
même hyperviseur n'est pas concerné. La redondance (deux route reflectors) ou
``graceful-restart`` sont les deux leviers ; ni l'un ni l'autre n'est encore qualifié.
**Les tunnels ne survivent pas à la perte de tous les route reflectors.** Sans
``graceful-restart``, quand plus aucun route reflector ne répond, les sessions EVPN des
hyperviseurs tombent, FRR retire les routes apprises et, avec elles, le VTEP distant et
l'entrée d'inondation du VXLAN : **plus aucun paquet ne passe** entre hyperviseurs, jusqu'au
retour d'un route reflector et à la reconvergence des sessions. Le trafic entre VM d'un même
hyperviseur n'est pas concerné. Avec deux route reflectors, la perte de l'un est sans effet sur
le trafic, à condition qu'ils ne tombent jamais ensemble : **jamais deux route reflectors sur le
même hyperviseur**. Les mesures du lab sont dans :doc:`/developpement/lab`.
.. note::
@ -101,8 +104,8 @@ Ce qu'elle établit :
autres ou d'un cas particulier — l'image, elle, est l'image golden de :doc:`image-qcow2` ;
* le placement des deux VM : jamais sur le même hyperviseur, et de préférence pas sur un
hyperviseur dont la perte isolerait l'autre ;
* la procédure de reconstruction — l'état du cluster pendant l'absence du route reflector est
décrit ci-dessus : plus de trafic entre hyperviseurs ;
* la procédure de reconstruction — l'état du cluster pendant l'absence de tous les route
reflectors est décrit ci-dessus : plus de trafic entre hyperviseurs ;
* la procédure d'amorçage : ce qui fonctionne, et dans quel ordre, quand on démarre un cluster
entier depuis zéro — le premier hyperviseur n'a pas de session FRR établie tant que cette VM
n'existe pas, cf. :doc:`premier-hyperviseur`.

View file

@ -18,9 +18,10 @@ Routeurs de bordure
Routeur de cluster
------------------
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des deux route
reflectors, dont il apprend les loopbacks : c'est par lui que chaque hyperviseur joint
``10.255.255.1`` et ``10.255.255.2`` pour ouvrir ses sessions EVPN (:doc:`route-reflector`).
Le routeur de cluster est la passerelle des hyperviseurs et le voisin eBGP des route reflectors
— au moins un ; deux sont prévus dans l'architecture et dans les exemples —, dont il apprend les
loopbacks : c'est par lui que chaque hyperviseur joint ``10.255.255.1`` et ``10.255.255.2`` pour
ouvrir ses sessions EVPN (:doc:`route-reflector`).
Adressage
~~~~~~~~~
@ -33,8 +34,9 @@ Adressage
- Interface
- Rôle
* - ``192.168.14.1/24``
- interface du segment des hyperviseurs
- passerelle par défaut des hyperviseurs et du route reflector
- interface du segment des hyperviseurs, **adresse virtuelle VRRP**
- passerelle par défaut des hyperviseurs et des route reflectors, portée par le routeur
maître ; chaque routeur a en plus sa propre adresse sur le segment
* - ``169.254.0.1/28``
- même interface, **adresse secondaire**
- lien avec les route reflectors (``169.254.0.3`` et ``.4``) ; ``router-id`` ; le second
@ -60,9 +62,9 @@ Ce qu'elle établit :
* **Aucune session avec les hyperviseurs** : le routeur leur sert de passerelle, pas de voisin BGP.
Celle du second routeur (``test/e2e/topologies/frr/sw2.conf``) ne diffère que par ``hostname`` et
``router-id`` (``169.254.0.2``), que les route reflectors déclarent aussi. La redondance des
routeurs — et le mécanisme qui fait basculer la passerelle ``192.168.14.1`` — est l'objet de
`#54 <https://git.g3e.fr/syonad/two/issues/54>`_.
``router-id`` (``169.254.0.2``), que les route reflectors déclarent aussi. Les deux routeurs se
partagent la passerelle ``192.168.14.1`` en **VRRP v3** : le maître la porte, l'autre attend, sans
préemption (`#54 <https://git.g3e.fr/syonad/two/issues/54>`_, fermé).
.. note::
@ -73,9 +75,8 @@ routeurs — et le mécanisme qui fait basculer la passerelle ``192.168.14.1``
**À rédiger.** Reste à documenter, faute d'éléments de terrain :
* pour le routeur de cluster : le matériel employé et sa version de référence ; la redondance
— deux routeurs, mécanisme de bascule, comportement attendu pendant une bascule
(`#54 <https://git.g3e.fr/syonad/two/issues/54>`_) ;
* pour le routeur de cluster : le matériel employé et sa version de référence ; la traduction
de la redondance VRRP v3 dans sa configuration ;
* pour les routeurs de datacentre et de bordure : tout — équipement, configuration de
référence, ce qui est annoncé et filtré à chaque niveau, redondance ;
* l'ordre de mise en service, et ce qui doit être opérationnel avant de préparer le premier