docs: build de 9477dc91d2
This commit is contained in:
parent
080c3e1f0e
commit
0626b4b97d
9 changed files with 117 additions and 14 deletions
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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"><ip></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-<id></span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">brl3-<id></span></code>, <code class="docutils literal notranslate"><span class="pre">vxl3-<id></span></code>, <code class="docutils literal notranslate"><span class="pre">l3-<id>-o</span></code> et, dans le netns, <code class="docutils literal notranslate"><span class="pre">l3-<id>-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"><l3vni></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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue