This commit is contained in:
forgejo-actions 2026-10-11 18:50:47 +00:00
commit 0626b4b97d
9 changed files with 117 additions and 14 deletions

View file

@ -866,7 +866,8 @@ accepté.</p></li>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
<td><p>conflit d’existence ou d’état : ressource déjà créée, ou suppression depuis un état qui
ne l’autorise pas ; pour un VPC, subnets encore présents</p></td>
ne l’autorise pas ; pour un VPC, subnets encore présents ; pour un subnet, VM non
supprimées qui l’utilisent encore</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
<td><p>dépendance absente ou pas prête : VPC parent d’un subnet, subnet d’une VM</p></td>

View file

@ -369,7 +369,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="w"> </span><span class="p">}</span>
<span class="p">]</span>
</pre></div>
@ -402,7 +403,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="p">{</span>
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="p">}</span>
</pre></div>
</div>
@ -417,12 +419,13 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="p">{</span>
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field or invalid request body</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/400">400 Bad Request</a></span> – <p>Missing required field, invalid request body, or l3vni out of range</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">400</span> <span class="ne">Bad Request</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
@ -433,7 +436,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC already exists</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC already exists, l3vni already used by another VPC, or l3vni requested on an agent without a bgp section</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
@ -487,7 +490,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="p">{</span>
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="p">}</span>
</pre></div>
</div>
@ -539,7 +543,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="p">{</span>
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"state"</span><span class="p">:</span><span class="w"> </span><span class="s2">"creating"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="nt">"cidr"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"l3vni"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="p">}</span>
</pre></div>
</div>
@ -1164,7 +1169,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and no VM that is not deleted may still have an interface on it</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>

View file

@ -346,6 +346,7 @@
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveurs">Serveurs</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#execution-des-commandes">Exécution des commandes</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correspondance-des-interfaces">Correspondance des interfaces</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#plan-de-controle-bgp">Plan de contrôle BGP</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metadata-et-qemu">Metadata et QEMU</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#backend-dhcp">Backend DHCP</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#bascule-d-un-backend-a-l-autre">Bascule d’un backend à l’autre</a></li>
@ -457,6 +458,35 @@ d’images), une valeur confortable évite un système de fichiers invité incoh
inconnue ou omise retombe silencieusement sur <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> — ce n’est pas une erreur,
mais c’est une source de subnets branchés au mauvais endroit sans le dire.</p>
</section>
<section id="plan-de-controle-bgp">
<h2>Plan de contrôle BGP<a class="headerlink" href="#plan-de-controle-bgp" title="Lien vers cette rubrique">#</a></h2>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">bgp</span><span class="p">:</span>
<span class="w"> </span><span class="nt">asn</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">64600</span>
<span class="w"> </span><span class="nt">route_reflectors</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">10.255.255.1</span><span class="p p-Indicator">]</span>
</pre></div>
</div>
<p>Section <strong>facultative</strong>. Absente, l’agent ne touche pas à FRR : sa configuration reste à poser
à la main, comme avant. Présente, l’agent <strong>pilote la configuration BGP de l’hyperviseur</strong> :
à chaque démarrage, avant d’ouvrir son API, il applique par <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> la base décrite dans
<a class="reference internal" href="../deploiement/premier-hyperviseur.html"><span class="doc">Premier hyperviseur</span></a>, puis l’enregistre par <code class="docutils literal notranslate"><span class="pre">write</span> <span class="pre">memory</span></code>.</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">asn</span></code> — l’AS de l’hyperviseur, commun à tous les hyperviseurs du cluster (iBGP vers le
route reflector). Obligatoire dès que la section existe.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">route_reflectors</span></code> — au moins une adresse IPv4, sans doublon. Un route reflector retiré de
la liste est retiré de FRR au démarrage suivant.</p></li>
</ul>
<p>Le <code class="docutils literal notranslate"><span class="pre">router-id</span></code> n’est pas configurable : c’est l’adresse IPv4 primaire de
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>, celle qui sert de VTEP.</p>
<p>Le démarrage <strong>échoue</strong> si la section est incomplète, si <code class="docutils literal notranslate"><span class="pre">default_interface</span></code> n’a pas
d’adresse IPv4 primaire, si <code class="docutils literal notranslate"><span class="pre">vtysh</span></code> refuse une commande, ou si FRR tourne déjà sous un autre
AS : changer d”<code class="docutils literal notranslate"><span class="pre">asn</span></code> suppose de retirer l’ancienne instance à la main.</p>
<div class="admonition warning">
<p class="admonition-title">Avertissement</p>
<p><code class="docutils literal notranslate"><span class="pre">/etc/frr/frr.conf</span></code> devient un fichier <strong>généré</strong> : <code class="docutils literal notranslate"><span class="pre">write</span> <span class="pre">memory</span></code> le réécrit à partir de
la configuration en mémoire de FRR. Une modification faite dans le fichier sans être
rechargée est perdue au prochain démarrage de l’agent.</p>
</div>
</section>
<section id="metadata-et-qemu">
<h2>Metadata et QEMU<a class="headerlink" href="#metadata-et-qemu" title="Lien vers cette rubrique">#</a></h2>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">metadata</span><span class="p">:</span>
@ -613,6 +643,7 @@ l’autre.</p>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#serveurs">Serveurs</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#execution-des-commandes">Exécution des commandes</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#correspondance-des-interfaces">Correspondance des interfaces</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#plan-de-controle-bgp">Plan de contrôle BGP</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metadata-et-qemu">Metadata et QEMU</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#backend-dhcp">Backend DHCP</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#bascule-d-un-backend-a-l-autre">Bascule d’un backend à l’autre</a></li>

View file

@ -400,6 +400,19 @@ toujours sur le système, et <strong>notifie les écarts sans jamais réparer</s
</div>
<p>Il contrôle notamment l’existence des network namespaces, des liens réseau des subnets, des taps
de VM et la réponse des units systemd associées.</p>
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans la configuration, il contrôle aussi le plan de contrôle :</p>
<ul class="simple">
<li><p><strong>Sessions BGP</strong> : une notification par route reflector dont la session n’est pas
<code class="docutils literal notranslate"><span class="pre">Established</span></code> (<code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">bgp</span> <span class="pre">neighbors</span> <span class="pre">&lt;ip&gt;</span></code>).</p></li>
<li><p><strong>VPC routés</strong> (<code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, état <code class="docutils literal notranslate"><span class="pre">running</span></code>) : présence et état des interfaces <code class="docutils literal notranslate"><span class="pre">vrf-&lt;id&gt;</span></code>,
<code class="docutils literal notranslate"><span class="pre">brl3-&lt;id&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">vxl3-&lt;id&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">l3-&lt;id&gt;-o</span></code> et, dans le netns, <code class="docutils literal notranslate"><span class="pre">l3-&lt;id&gt;-i</span></code> ; L3VNI de type
<code class="docutils literal notranslate"><span class="pre">L3</span></code>, <code class="docutils literal notranslate"><span class="pre">Up</span></code>, avec la MAC de routeur attendue (<code class="docutils literal notranslate"><span class="pre">show</span> <span class="pre">evpn</span> <span class="pre">vni</span> <span class="pre">&lt;l3vni&gt;</span></code>).</p></li>
<li><p><strong>Réconciliation des routes exportées</strong> dans la VRF : chaque <code class="docutils literal notranslate"><span class="pre">/24</span></code> de subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> et chaque
<code class="docutils literal notranslate"><span class="pre">/32</span></code> d’interface de VM <code class="docutils literal notranslate"><span class="pre">running</span></code> doit être exporté ; à l’inverse, une route exportée dont
le propriétaire n’existe plus — ni <code class="docutils literal notranslate"><span class="pre">running</span></code>, ni en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> —
est signalée comme un <strong>trou noir</strong> : l’annonce attire du trafic que plus rien ne reçoit.</p></li>
</ul>
<p>Un VPC routé alors que la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> a disparu de la configuration est signalé lui aussi.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Un écart persistant est signalé <strong>à chaque tick</strong>, sans déduplication. Le volume de