docs: build de 1828053e6d
This commit is contained in:
parent
0626b4b97d
commit
d081a75883
7 changed files with 209 additions and 42 deletions
|
|
@ -360,7 +360,8 @@
|
|||
|
||||
<section id="bael">
|
||||
<h1>Bael<a class="headerlink" href="#bael" title="Lien vers cette rubrique">#</a></h1>
|
||||
<p>Serveur DHCP intégré, en coexistence avec dnsmasq, et documentation du projet.</p>
|
||||
<p>Serveur DHCP intégré, en coexistence avec dnsmasq ; routage inter-subnet entre hyperviseurs par
|
||||
L3VNI, avec une configuration BGP pilotée par l’agent ; documentation du projet.</p>
|
||||
<section id="fonctionnalites">
|
||||
<h2>Fonctionnalités<a class="headerlink" href="#fonctionnalites" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p><strong>Serveur DHCP intégré</strong></p>
|
||||
|
|
@ -390,8 +391,44 @@ comporte exactement comme avant</p></li>
|
|||
subnet déjà créé reste servi par le serveur qui l’a été. La procédure est documentée</p></li>
|
||||
<li><p>Toute valeur autre que <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> ou <code class="docutils literal notranslate"><span class="pre">two</span></code> fait échouer le démarrage de l’agent</p></li>
|
||||
</ul>
|
||||
<p><strong>Routage inter-subnet entre hyperviseurs : L3VNI (#41)</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Nouveau champ facultatif <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> sur <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vpcs</span></code> (1 à 16777215, sauf 253-255 : c’est aussi
|
||||
l’identifiant de la table de routage). Absent, le VPC se comporte comme avant. Une L3VNI déjà
|
||||
portée par un VPC de l’agent est refusée (409), comme un <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandé sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code></p></li>
|
||||
<li><p>Pour un VPC routé, l’agent pose sur l’hyperviseur une VRF (table = L3VNI), un bridge à la MAC de
|
||||
routeur <code class="docutils literal notranslate"><span class="pre">02:02:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></span></code>, le VXLAN de la L3VNI, un lien de transit <code class="docutils literal notranslate"><span class="pre">169.254.0.1/30</span></code> ↔
|
||||
<code class="docutils literal notranslate"><span class="pre">169.254.0.2/30</span></code> vers le netns et la route du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC dans le netns ; FRR reçoit la VRF,
|
||||
sa <code class="docutils literal notranslate"><span class="pre">vni</span></code>, une instance <code class="docutils literal notranslate"><span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> (RD <code class="docutils literal notranslate"><span class="pre"><VTEP>:<l3vni></span></code>, RT <code class="docutils literal notranslate"><span class="pre"><asn>:<l3vni></span></code>) et l’export
|
||||
des routes du <code class="docutils literal notranslate"><span class="pre">cidr</span></code>. Un hyperviseur n’a plus besoin de porter un subnet pour joindre ses VM</p></li>
|
||||
<li><p>Routes annoncées : le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de chaque subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> à sa création, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> de chaque interface
|
||||
de VM juste avant son passage en <code class="docutils literal notranslate"><span class="pre">running</span></code> ; retirés en premier à la suppression</p></li>
|
||||
<li><p>La suppression d’un VPC routé retire la configuration de routage de FRR, puis les interfaces,
|
||||
puis la VRF de FRR — dans cet ordre, faute de quoi <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> plante (FRR 10.7.1)</p></li>
|
||||
</ul>
|
||||
<p><strong>Configuration BGP pilotée par l’agent</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Nouvelle section facultative <code class="docutils literal notranslate"><span class="pre">bgp</span></code> (<code class="docutils literal notranslate"><span class="pre">asn</span></code>, <code class="docutils literal notranslate"><span class="pre">route_reflectors</span></code>). Présente, l’agent applique à
|
||||
chaque démarrage, par <code class="docutils literal notranslate"><span class="pre">vtysh</span></code>, la base BGP de l’hyperviseur (router-id = VTEP, peer-group
|
||||
<code class="docutils literal notranslate"><span class="pre">fabric</span></code> vers les route reflectors, EVPN, <code class="docutils literal notranslate"><span class="pre">advertise-all-vni</span></code>) et l’enregistre :
|
||||
<code class="docutils literal notranslate"><span class="pre">/etc/frr/frr.conf</span></code> devient un fichier généré. Un route reflector retiré de la liste est retiré
|
||||
de FRR. Absente, l’agent ne touche pas à FRR</p></li>
|
||||
<li><p>Le démarrage échoue si la section est incomplète, si FRR tourne déjà sous un autre AS ou si
|
||||
<code class="docutils literal notranslate"><span class="pre">vtysh</span></code> ne répond pas</p></li>
|
||||
</ul>
|
||||
<p><strong>Gateway des subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code></strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Le bridge du subnet porte une <strong>MAC propre à l’hôte</strong>, <code class="docutils literal notranslate"><span class="pre">02:03:<IPv4</span> <span class="pre">du</span> <span class="pre">VTEP></span></code>, posée à la
|
||||
création du subnet. Une MAC identique sur tous les hôtes (anycast) a été essayée puis retirée :
|
||||
annoncée en double en EVPN, elle empêchait aussi une gateway de joindre en L2 une VM d’un autre
|
||||
hôte (#57)</p></li>
|
||||
</ul>
|
||||
<p><strong>Exploitation</strong></p>
|
||||
<ul class="simple">
|
||||
<li><p>Le watchdog contrôle aussi, avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> : les sessions vers les route reflectors ;
|
||||
pour chaque VPC routé, les interfaces de la VRF et l’état de la L3VNI dans FRR (type, état, MAC
|
||||
de routeur) ; la cohérence entre routes exportées et ressources <code class="docutils literal notranslate"><span class="pre">running</span></code> — une route exportée
|
||||
sans propriétaire est signalée comme <strong>trou noir</strong>, une route attendue absente comme manquante</p></li>
|
||||
<li><p>Le watchdog interroge le serveur DHCP intégré et compare les réservations servies à celles que
|
||||
la base implique. Il nomme ce qui diverge — ordre perdu à la création, ordre perdu à la
|
||||
suppression, adresse ou route par défaut divergente — et reste en lecture seule</p></li>
|
||||
|
|
@ -403,6 +440,9 @@ ce qui serait envoyé à une MAC donnée : adresse, masque, routeur, DNS et rout
|
|||
<section id="correctifs">
|
||||
<h2>Correctifs<a class="headerlink" href="#correctifs" title="Lien vers cette rubrique">#</a></h2>
|
||||
<ul class="simple">
|
||||
<li><p><strong>Suppression d’un subnet refusée tant qu’une VM non supprimée l’utilise</strong> (409, avec la liste
|
||||
des VM), pour tous les subnets : garantit qu’une route <code class="docutils literal notranslate"><span class="pre">/32</span></code> est retirée avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
|
||||
subnet, ce qui évite un trou noir partiel mesuré en lab</p></li>
|
||||
<li><p><strong>Un fichier de configuration présent mais invalide fait désormais échouer le démarrage.</strong>
|
||||
Jusqu’en 0.1.0 l’erreur de lecture était ignorée : l’agent tournait alors entièrement sur ses
|
||||
valeurs par défaut sans le dire, ce qui rendait indétectable une simple tabulation d’indentation</p></li>
|
||||
|
|
@ -413,6 +453,11 @@ champ et de le rendre indistinguable d’une réponse tronquée</p></li>
|
|||
<section id="changements-internes">
|
||||
<h2>Changements internes<a class="headerlink" href="#changements-internes" title="Lien vers cette rubrique">#</a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>Nouveaux paquets <code class="docutils literal notranslate"><span class="pre">internal/frr</span></code> (seul point d’appel à <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> : génération des commandes,
|
||||
démontage ordonné, relecture de la configuration après démontage) et <code class="docutils literal notranslate"><span class="pre">internal/sysctl</span></code> ; une
|
||||
remarque de <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> (« Configuration applied with notes ») n’est pas une erreur, et la
|
||||
suppression d’une instance BGP de VRF est réessayée tant que <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> n’a pas libéré la L3VNI</p></li>
|
||||
<li><p>Les tests du dispatcher arrêtent les workers avant de fermer la base (#47)</p></li>
|
||||
<li><p>Le module passe à <strong>Go 1.25</strong>, exigé par la bibliothèque DHCP retenue. La version de Go du
|
||||
workflow de build, restée à 1.21 alors que le module en demandait davantage, est alignée</p></li>
|
||||
<li><p>Nouveau paquet <code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code> : persistance générique d’un état de composant dans un
|
||||
|
|
@ -427,6 +472,14 @@ d’état, dans un <code class="docutils literal notranslate"><span class="pre">
|
|||
<h2>Périmètre et limites connues<a class="headerlink" href="#perimetre-et-limites-connues" title="Lien vers cette rubrique">#</a></h2>
|
||||
<p>Celles de la 0.1.0 restent valables, sauf mention contraire ci-dessus. S’y ajoutent :</p>
|
||||
<ul class="simple">
|
||||
<li><p><strong>L3VNI</strong> : pas de migration à chaud ; le cache ARP d’une VM qui changerait d’hôte reste à
|
||||
traiter (#57). MTU 1500 de bout en bout (#56). Un seul route reflector qualifié (#54). Le
|
||||
transit <code class="docutils literal notranslate"><span class="pre">169.254.0.0/30</span></code> étant identique sur tous les hôtes, les ICMP des sauts distants sont
|
||||
rejetés comme « martiens » (traceroute partiel)</p></li>
|
||||
<li><p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, l’agent ne démarre pas sans FRR et <code class="docutils literal notranslate"><span class="pre">agent.service</span></code> ne le relance pas :
|
||||
au démarrage, l’ordre est migration réseau, puis FRR, puis l’agent (#52)</p></li>
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">bootstrap_kvm.sh</span></code> active <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span></code> en global ; le forwarding que l’agent active
|
||||
sur les seules interfaces de la VRF n’en restreint donc pas la portée</p></li>
|
||||
<li><p><strong>dnsmasq n’est pas retiré</strong> et reste un paquet requis : le backend intégré ne sert que les
|
||||
subnets créés après la bascule, et le retour arrière suppose dnsmasq installé</p></li>
|
||||
<li><p>Pas de DNS, pas de pool dynamique, pas de PXE, pas de DHCPv6 dans le serveur intégré</p></li>
|
||||
|
|
@ -446,8 +499,12 @@ le dialogue avec le serveur intégré, est couvert sur toute plateforme</p></li>
|
|||
bash<span class="w"> </span>./deploy.sh<span class="w"> </span>-t<span class="w"> </span><span class="m">0</span>.2.0
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Aucune action n’est requise : sans <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, le comportement est
|
||||
celui de la 0.1.0. Pour passer au serveur intégré, suivre la procédure de bascule dans la
|
||||
<p>Aucune action n’est requise : sans <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> ni <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, le
|
||||
comportement est celui de la 0.1.0, à une exception près — <strong>un subnet encore utilisé par une VM
|
||||
ne se supprime plus</strong> : supprimer les VM d’abord. Les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> existants gardent leur MAC
|
||||
de gateway jusqu’à leur recréation.</p>
|
||||
<p>Pour router entre hyperviseurs : ajouter la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code>, réduire <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code> à <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
|
||||
<code class="docutils literal notranslate"><span class="pre">log</span></code> (l’agent pose le reste), puis créer les VPC avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>. Pour passer au serveur intégré, suivre la procédure de bascule dans la
|
||||
documentation d’exploitation — elle suppose un hyperviseur vidé.</p>
|
||||
</section>
|
||||
</section>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue