This commit is contained in:
forgejo-actions 2026-10-11 23:12:04 +00:00
commit d081a75883
7 changed files with 209 additions and 42 deletions

View file

@ -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:&lt;IPv4</span> <span class="pre">du</span> <span class="pre">VTEP&gt;</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">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code>, RT <code class="docutils literal notranslate"><span class="pre">&lt;asn&gt;:&lt;l3vni&gt;</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:&lt;IPv4</span> <span class="pre">du</span> <span class="pre">VTEP&gt;</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>