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

@ -360,6 +360,7 @@
de sérialisation structurée.</p> de sérialisation structurée.</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vpc/&lt;name&gt;/state → creating | running | error | deleting | deleted <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vpc/&lt;name&gt;/state → creating | running | error | deleting | deleted
vpc/&lt;name&gt;/cidr → &lt;cidr&gt; vpc/&lt;name&gt;/cidr → &lt;cidr&gt;
vpc/&lt;name&gt;/l3vni → &lt;id&gt; (optionnel : VPC routé par L3VNI)
subnet/&lt;name&gt;/state → creating | running | error | deleting | deleted subnet/&lt;name&gt;/state → creating | running | error | deleting | deleted
subnet/&lt;name&gt;/vpc → &lt;vpc-name&gt; subnet/&lt;name&gt;/vpc → &lt;vpc-name&gt;

View file

@ -844,6 +844,11 @@ configuration réseau côté host n’existe pas encore : la création part en <
BR --- VX[&quot;vxlan&amp;lt;vni&amp;gt;&quot;] --- HBR[&quot;bridge host&lt;br/&gt;(iface_type)&quot;] --- UP[uplink] BR --- VX[&quot;vxlan&amp;lt;vni&amp;gt;&quot;] --- HBR[&quot;bridge host&lt;br/&gt;(iface_type)&quot;] --- UP[uplink]
</pre><p>Le subnet vit dans le netns du VPC. La VM n’est donc <strong>pas joignable depuis l’host</strong> sans route </pre><p>Le subnet vit dans le netns du VPC. La VM n’est donc <strong>pas joignable depuis l’host</strong> sans route
explicite — point à connaître avant de câbler un outil externe dessus.</p> explicite — point à connaître avant de câbler un outil externe dessus.</p>
<p>Le bridge du subnet, qui porte <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code>, a une <strong>MAC de gateway anycast</strong> calculée depuis
le <code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> : <code class="docutils literal notranslate"><span class="pre">02:01:00</span></code> suivi des 24 bits de la VNI (<code class="docutils literal notranslate"><span class="pre">vxlan_id</span></code> 2811 →
<code class="docutils literal notranslate"><span class="pre">02:01:00:00:0a:fb</span></code>). Elle est identique sur tous les hôtes qui portent le subnet : une VM qui
change d’hôte garde une entrée ARP valide pour sa gateway. Elle n’est posée qu’à la création du
subnet — un subnet créé avant garde la MAC choisie par le noyau jusqu’à sa recréation.</p>
</section> </section>
<section id="bridge"> <section id="bridge">
<h2>bridge<a class="headerlink" href="#bridge" title="Lien vers cette rubrique">#</a></h2> <h2>bridge<a class="headerlink" href="#bridge" title="Lien vers cette rubrique">#</a></h2>

View file

@ -778,7 +778,10 @@ window.runMermaid = runMermaid;</script>
</div> </div>
<nav aria-label="Page"> <nav aria-label="Page">
<ul class="visible nav section-nav flex-column"> <ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#routage-entre-hyperviseurs-l3vni">Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code></a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li>
@ -809,6 +812,30 @@ window.runMermaid = runMermaid;</script>
<p>Un VPC est un <strong>network namespace</strong> portant un espace d’adressage (<code class="docutils literal notranslate"><span class="pre">cidr</span></code>). C’est l’unité <p>Un VPC est un <strong>network namespace</strong> portant un espace d’adressage (<code class="docutils literal notranslate"><span class="pre">cidr</span></code>). C’est l’unité
d’isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d’adresses.</p> d’isolation : deux VPC ne se voient pas, et peuvent réutiliser les mêmes plages d’adresses.</p>
<p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p> <p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p>
<section id="routage-entre-hyperviseurs-l3vni">
<h3>Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code><a class="headerlink" href="#routage-entre-hyperviseurs-l3vni" title="Lien vers cette rubrique">#</a></h3>
<p>Un VPC créé avec <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> route ses subnets entre hyperviseurs par un <strong>VNI de transit</strong> propre
au VPC (IRB symétrique, <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a>) : un hyperviseur n’a
plus besoin de porter un subnet pour joindre ses VM. Sans <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, le VPC se comporte comme
avant. Le champ exige la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de l’agent (<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>) et ne
se change pas après création.</p>
<p>À la création, l’agent pose sur l’hyperviseur, pour un VPC <code class="docutils literal notranslate"><span class="pre">vp-&lt;id&gt;</span></code> :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>vrf-&lt;id&gt; VRF, table de routage = l3vni
├── brl3-&lt;id&gt; bridge sans adresse, MAC de routeur 02:02:&lt;IPv4 du VTEP&gt;
│ └── vxl3-&lt;id&gt; VXLAN du l3vni, VTEP = IPv4 primaire de default_interface
└── l3-&lt;id&gt;-o 169.254.0.1/30 ── l3-&lt;id&gt;-i 169.254.0.2/30, dans le netns du VPC
</pre></div>
</div>
<p>Dans le netns, le <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC est routé vers <code class="docutils literal notranslate"><span class="pre">169.254.0.1</span></code> ; le transit <code class="docutils literal notranslate"><span class="pre">/30</span></code> est le même
sur tous les hyperviseurs et pour tous les VPC. Le forwarding IPv4 est activé dans le netns, et
sur l’hôte <strong>seulement</strong> sur <code class="docutils literal notranslate"><span class="pre">brl3-&lt;id&gt;</span></code> et <code class="docutils literal notranslate"><span class="pre">l3-&lt;id&gt;-o</span></code> : l’hyperviseur ne devient pas un
routeur entre ses autres interfaces. FRR reçoit la VRF, son <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">&lt;asn&gt;</span> <span class="pre">vrf</span> <span class="pre">vrf-&lt;id&gt;</span></code> avec RD <code class="docutils literal notranslate"><span class="pre">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code> et 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> présentes dans la VRF.</p>
<p>La suppression retire d’abord la configuration de routage de FRR, puis les interfaces, puis la
VRF de FRR. Cet ordre est imposé : supprimer la VRF du noyau sous une instance BGP encore
configurée fait planter <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> (FRR 10.7.1).</p>
</section>
</section> </section>
<section id="subnet"> <section id="subnet">
<h2>Subnet<a class="headerlink" href="#subnet" title="Lien vers cette rubrique">#</a></h2> <h2>Subnet<a class="headerlink" href="#subnet" title="Lien vers cette rubrique">#</a></h2>
@ -820,6 +847,10 @@ bridge physique par la configuration de l’agent. Une clé absente ou inconnue
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>. Ce niveau d’indirection permet au même appel d’API de fonctionner sur des <code class="docutils literal notranslate"><span class="pre">default_interface</span></code>. Ce niveau d’indirection permet au même appel d’API de fonctionner sur des
hosts dont le nommage réseau diffère.</p> hosts dont le nommage réseau diffère.</p>
<p>Le comportement réseau dépend du <a class="reference internal" href="modes-reseau.html"><span class="doc">mode</span></a>.</p> <p>Le comportement réseau dépend du <a class="reference internal" href="modes-reseau.html"><span class="doc">mode</span></a>.</p>
<p>Un subnet ne peut être supprimé que si aucune VM non supprimée n’a d’interface dessus — sinon
409, avec la liste des VM. Dans un VPC routé par <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> annonce son
préfixe dans la VRF du VPC à la création et le retire en premier à la suppression : c’est le
filet qui couvre une VM tant que son <code class="docutils literal notranslate"><span class="pre">/32</span></code> n’est pas annoncé.</p>
</section> </section>
<section id="vm"> <section id="vm">
<h2>VM<a class="headerlink" href="#vm" title="Lien vers cette rubrique">#</a></h2> <h2>VM<a class="headerlink" href="#vm" title="Lien vers cette rubrique">#</a></h2>
@ -828,6 +859,11 @@ hosts dont le nommage réseau diffère.</p>
le nom de l’interface dans le guest. Exactement une interface doit être <code class="docutils literal notranslate"><span class="pre">primary</span></code> : elle porte le nom de l’interface dans le guest. Exactement une interface doit être <code class="docutils literal notranslate"><span class="pre">primary</span></code> : elle porte
la route par défaut et le serveur de metadata. Tous les subnets d’une VM doivent appartenir au la route par défaut et le serveur de metadata. Tous les subnets d’une VM doivent appartenir au
<strong>même VPC</strong>.</p> <strong>même VPC</strong>.</p>
<p><strong>Routes.</strong> Dans un VPC routé par <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, chaque interface sur un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> est annoncée
en <code class="docutils literal notranslate"><span class="pre">/32</span></code> dans la VRF du VPC une fois QEMU démarré, juste avant le passage en <code class="docutils literal notranslate"><span class="pre">running</span></code>. À la
suppression, ces <code class="docutils literal notranslate"><span class="pre">/32</span></code> sont retirés <strong>avant</strong> l’arrêt de QEMU. Comme un subnet ne peut être
supprimé tant qu’une VM l’utilise, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> d’une VM est toujours retiré avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
subnet — l’ordre qui évite le trou noir de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a>.</p>
<p><strong>Stockage.</strong> Un seul disque <code class="docutils literal notranslate"><span class="pre">vdX</span></code> (virtio-blk) par VM ; les disques supplémentaires passent <p><strong>Stockage.</strong> Un seul disque <code class="docutils literal notranslate"><span class="pre">vdX</span></code> (virtio-blk) par VM ; les disques supplémentaires passent
par le contrôleur SCSI (<code class="docutils literal notranslate"><span class="pre">sdX</span></code>). Cette contrainte vient de la carte PCI figée — voir par le contrôleur SCSI (<code class="docutils literal notranslate"><span class="pre">sdX</span></code>). Cette contrainte vient de la carte PCI figée — voir
<a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>.</p> <a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>.</p>
@ -894,7 +930,10 @@ convention <code class="docutils literal notranslate"><span class="pre">vp-</spa
</div> </div>
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2"> <nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
<ul class="visible nav section-nav flex-column"> <ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vpc">VPC</a><ul class="nav section-nav flex-column">
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#routage-entre-hyperviseurs-l3vni">Routage entre hyperviseurs : <code class="docutils literal notranslate"><span class="pre">l3vni</span></code></a></li>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#subnet">Subnet</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#vm">VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li> <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#ce-qui-est-stocke-et-ou">Ce qui est stocké, et où</a></li>

View file

@ -383,8 +383,16 @@ l’agent désactive l’apprentissage et ne configure aucun voisin — cf.
<a class="reference internal" href="architecture-cluster.html"><span class="doc">Architecture du cluster</span></a>.</p> <a class="reference internal" href="architecture-cluster.html"><span class="doc">Architecture du cluster</span></a>.</p>
<section id="configuration-de-frr"> <section id="configuration-de-frr">
<h3>Configuration de FRR<a class="headerlink" href="#configuration-de-frr" title="Lien vers cette rubrique">#</a></h3> <h3>Configuration de FRR<a class="headerlink" href="#configuration-de-frr" title="Lien vers cette rubrique">#</a></h3>
<p>Seul <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> est activé dans <code class="docutils literal notranslate"><span class="pre">/etc/frr/daemons</span></code>. D’un hyperviseur à l’autre ne changent que <p>Seul <code class="docutils literal notranslate"><span class="pre">bgpd</span></code> est activé dans <code class="docutils literal notranslate"><span class="pre">/etc/frr/daemons</span></code>. Le reste est posé par l’agent, à chaque
<code class="docutils literal notranslate"><span class="pre">hostname</span></code> et <code class="docutils literal notranslate"><span class="pre">router-id</span></code>, l’adresse de l’hyperviseur sur son segment.</p> démarrage, à partir de la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> de <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code> (<a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>) :</p>
<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>L’agent en déduit la configuration ci-dessous ; le <code class="docutils literal notranslate"><span class="pre">router-id</span></code> est l’adresse IPv4 primaire de
<code class="docutils literal notranslate"><span class="pre">default_interface</span></code>, la seule valeur qui change d’un hyperviseur à l’autre. <code class="docutils literal notranslate"><span class="pre">hostname</span></code> et
<code class="docutils literal notranslate"><span class="pre">log</span></code> ne sont pas gérés par l’agent.</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>frr defaults traditional
hostname hv1 hostname hv1
log syslog informational log syslog informational

View file

@ -866,7 +866,8 @@ accepté.</p></li>
</tr> </tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td> <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 <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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td> <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> <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="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">"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">"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="w"> </span><span class="p">}</span>
<span class="p">]</span> <span class="p">]</span>
</pre></div> </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="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">"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> <span class="p">}</span>
</pre></div> </pre></div>
</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="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">"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">"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> <span class="p">}</span>
</pre></div> </pre></div>
</div> </div>
</p></li> </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> <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> <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> <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> </pre></div>
</div> </div>
</p></li> </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> <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> <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> <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="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">"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">"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> <span class="p">}</span>
</pre></div> </pre></div>
</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="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">"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">"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> <span class="p">}</span>
</pre></div> </pre></div>
</div> </div>
@ -1164,7 +1169,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div> </pre></div>
</div> </div>
</p></li> </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> <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> <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> <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="#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="#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="#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="#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-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> <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, 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> mais c’est une source de subnets branchés au mauvais endroit sans le dire.</p>
</section> </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"> <section id="metadata-et-qemu">
<h2>Metadata et QEMU<a class="headerlink" href="#metadata-et-qemu" title="Lien vers cette rubrique">#</a></h2> <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> <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="#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="#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="#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="#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-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> <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> </div>
<p>Il contrôle notamment l’existence des network namespaces, des liens réseau des subnets, des taps <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> 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"> <div class="admonition note">
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
<p>Un écart persistant est signalé <strong>à chaque tick</strong>, sans déduplication. Le volume de <p>Un écart persistant est signalé <strong>à chaque tick</strong>, sans déduplication. Le volume de

File diff suppressed because one or more lines are too long