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

@ -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]
</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>
<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 id="bridge">
<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>
<nav aria-label="Page">
<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="#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>
@ -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é
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>
<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 id="subnet">
<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
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>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 id="vm">
<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
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>
<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
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>
@ -894,7 +930,10 @@ convention <code class="docutils literal notranslate"><span class="pre">vp-</spa
</div>
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
<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="#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>