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:
parent
c5d7855a51
commit
48f12958cf
30 changed files with 271 additions and 190 deletions
|
|
@ -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
|
||||
---
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
---------------------------
|
||||
|
|
|
|||
|
|
@ -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`.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue