This commit is contained in:
forgejo-actions 2026-10-26 22:18:50 +00:00
commit edeb124501
10 changed files with 91 additions and 32 deletions

View file

@ -378,7 +378,7 @@ doit donc figurer dans la 121 ; l’option 3 ne sert que les clients qui n’imp
<li><p><strong>La route vers le CIDR du VPC garde ``interface_ip`` comme next-hop</strong> dans tous les modes sauf
<code class="docutils literal notranslate"><span class="pre">bridge</span></code> : sur un subnet à IP publique, le trafic interne ne doit pas sortir par la gateway
publique.</p></li>
<li><p><strong>La MAC anycast d’une gateway ``vxlan`` ne sort jamais du netns</strong> : règles ebtables sur le veth
<li><p><strong>La MAC anycast d’une gateway ``vxlan`` ne sort jamais du netns</strong> : règles nftables sur le veth
du subnet (source anycast rejetée en entrée et en sortie) <strong>et</strong> entrée FDB locale dans le bridge
du netns. Sans l’entrée FDB, que le macvlan ne crée pas, toute trame d’une VM vers sa gateway est
inondée vers le fabric et traitée par la gateway de chaque hôte.</p></li>
@ -410,6 +410,9 @@ casserait le démarrage (<code class="docutils literal notranslate"><span class=
<li><p>QEMU est lancé par <code class="docutils literal notranslate"><span class="pre">systemd-run</span> <span class="pre">--scope</span></code>, <strong>jamais</strong> en unit transitoire : le scope est
exécuté par le processus appelant et hérite du netns posé par <code class="docutils literal notranslate"><span class="pre">netns.Call</span></code>. Une unit
transitoire, forkée par PID 1, démarrerait dans le netns racine et ne verrait pas le tap.</p></li>
<li><p><strong>Un tap n’existe jamais sans ses règles</strong> : la chaîne <code class="docutils literal notranslate"><span class="pre">pre-tap&lt;id&gt;</span></code> est posée avant la
création du tap et retirée après sa suppression. Dans l’autre ordre, une VM pourrait émettre
sans filtre entre deux étapes.</p></li>
<li><p>L’arrêt d’une VM ne touche <strong>jamais</strong> aux fichiers disque. En revanche, un <code class="docutils literal notranslate"><span class="pre">quit</span></code> brutal est
envoyé à l’expiration de <code class="docutils literal notranslate"><span class="pre">times.timeout_vms_stop</span></code>. <code class="docutils literal notranslate"><span class="pre">system_powerdown</span></code> est renvoyé toutes les
<code class="docutils literal notranslate"><span class="pre">times.next_vms_shutdown</span></code> : un appui ACPI arrivé avant que l’invité sache le traiter est perdu.</p></li>

View file

@ -379,6 +379,7 @@ vm/&lt;name&gt;/nic/&lt;i&gt;/subnet → &lt;subnet-name&gt; (une interfac
vm/&lt;name&gt;/nic/&lt;i&gt;/ip → &lt;ip&gt;
vm/&lt;name&gt;/nic/&lt;i&gt;/mac → &lt;mac&gt; (fournie par l'appelant, conservée telle quelle)
vm/&lt;name&gt;/nic/&lt;i&gt;/primary → "true" (exactement une interface ; absent sur les autres)
vm/&lt;name&gt;/nic/&lt;i&gt;/dhcp_server → "true" (absent si l'interface ne sert pas le DHCP)
vm/&lt;name&gt;/nic/&lt;i&gt;/tap_id → &lt;int&gt; (alloué au premier démarrage, puis conservé)
vm/&lt;name&gt;/metadata_port → &lt;port&gt;
vm/&lt;name&gt;/disk/&lt;dev&gt; → &lt;path&gt; (une clé par disque : vda, xvda, xvdb, …)

View file

@ -421,7 +421,7 @@ une erreur.</p>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netif</span></code></p></td>
<td><p>netlink : bridge, veth, vxlan, tap, routes, adresses</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/ebtables</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/iptables</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/nft</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/iptables</span></code></p></td>
<td><p>wrappers dédiés ; ne pas appeler ces binaires ailleurs</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/qemu</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/qmp</span></code></p></td>

View file

@ -787,6 +787,7 @@ window.runMermaid = runMermaid;</script>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#bridge">bridge</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#regles-de-pont">Règles de pont</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#routes-annoncees-aux-vm">Routes annoncées aux VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#route-par-defaut-default-route-et-gateway">Route par défaut : <code class="docutils literal notranslate"><span class="pre">default_route</span></code> et <code class="docutils literal notranslate"><span class="pre">gateway</span></code></a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable">Pourquoi la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers le serveur de metadata est indispensable</a></li>
@ -901,8 +902,8 @@ trafic routé entre VM n’est pas concerné, il garde sa source.</p>
EVPN par chaque hôte, détectée en double, et déplacerait l’apprentissage des bridges. Trois
mécanismes la confinent :</p>
<ul class="simple">
<li><p>ebtables, sur le veth du subnet : toute trame de <strong>source</strong> anycast est rejetée à l’entrée
(<code class="docutils literal notranslate"><span class="pre">nat</span> <span class="pre">PREROUTING</span></code>) et à la sortie (<code class="docutils literal notranslate"><span class="pre">FORWARD</span></code> et <code class="docutils literal notranslate"><span class="pre">OUTPUT</span></code>) ;</p></li>
<li><p>nftables, sur le veth du subnet : toute trame de <strong>source</strong> anycast est rejetée à l’entrée
(<code class="docutils literal notranslate"><span class="pre">prerouting</span></code>) et à la sortie (<code class="docutils literal notranslate"><span class="pre">forward</span></code> et <code class="docutils literal notranslate"><span class="pre">output</span></code>) ;</p></li>
<li><p>une <strong>entrée FDB locale</strong> pour la MAC anycast dans le bridge du netns. Le macvlan ne la crée pas
lui-même : sans elle, toute trame d’une VM vers sa gateway est inondée vers le fabric et les
autres VM, et traitée par la gateway de chaque hôte ;</p></li>
@ -911,7 +912,7 @@ sont bloquées vers le veth, comme avant.</p></li>
</ul>
<p>IPv6 n’est pas désactivé sur le macvlan : ses trames (DAD, ND) sont arrêtées par le confinement.
Le watchdog contrôle le macvlan, sa MAC, les deux adresses et l’entrée FDB ; il ne relit pas les
règles ebtables.</p>
règles nftables.</p>
</section>
<section id="subnets-crees-avant-la-gateway-anycast">
<h3>Subnets créés avant la gateway anycast<a class="headerlink" href="#subnets-crees-avant-la-gateway-anycast" title="Lien vers cette rubrique">#</a></h3>
@ -927,19 +928,30 @@ quelques secondes (#57).</p>
VPC : le trafic sort par le bridge, et la VM est joignable depuis l’host.</p>
<p>Le même subnet peut être posé sur plusieurs hôtes raccordés au même segment. Chaque hôte porte
alors la <strong>même</strong> <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> dans son netns, avec sa propre MAC. Pour qu’une VM ne voie que
l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> de son hôte (gateway, metadata, DHCP), l’agent pose quatre règles ebtables sur
l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> de son hôte (gateway, metadata, DHCP), l’agent pose quatre règles nftables sur
le veth du subnet dans le netns (<code class="docutils literal notranslate"><span class="pre">v-&lt;subnet&gt;-i</span></code>), en sortie vers le bridge de l’host :</p>
<ul class="simple">
<li><p>les requêtes ARP des VM <strong>vers</strong> <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne quittent pas l’hôte (<code class="docutils literal notranslate"><span class="pre">FORWARD</span></code>) ;</p></li>
<li><p>les requêtes ARP des VM <strong>vers</strong> <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne quittent pas l’hôte (<code class="docutils literal notranslate"><span class="pre">forward</span></code>) ;</p></li>
<li><p>l’ARP émis <strong>depuis</strong> <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> par le netns, requêtes et réponses, ne sort pas
(<code class="docutils literal notranslate"><span class="pre">OUTPUT</span></code>) : une VM d’un autre hôte n’associe jamais <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> à cet hôte ;</p></li>
<li><p>le DHCP émis depuis <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne sort ni en transit (<code class="docutils literal notranslate"><span class="pre">FORWARD</span></code>) ni depuis le serveur
local lui-même (<code class="docutils literal notranslate"><span class="pre">OUTPUT</span></code>).</p></li>
(<code class="docutils literal notranslate"><span class="pre">output</span></code>) : une VM d’un autre hôte n’associe jamais <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> à cet hôte ;</p></li>
<li><p>le DHCP émis depuis <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne sort ni en transit (<code class="docutils literal notranslate"><span class="pre">forward</span></code>) ni depuis le serveur
local lui-même (<code class="docutils literal notranslate"><span class="pre">output</span></code>).</p></li>
</ul>
<p>Le trafic entre VM du subnet, sur un même hôte ou sur des hôtes différents, n’est pas concerné.
Par conception, une VM ne joint pas le netns d’un autre hôte. Les règles sont retirées à la
suppression du subnet ; une règle déjà absente ne fait pas échouer la suppression. Le watchdog
signale les règles manquantes.</p>
signale les règles manquantes et celles qui ne sont pas de l’agent.</p>
</section>
<section id="regles-de-pont">
<h2>Règles de pont<a class="headerlink" href="#regles-de-pont" title="Lien vers cette rubrique">#</a></h2>
<p>Dans les deux modes, les règles de couche 2 vivent dans une table nftables <code class="docutils literal notranslate"><span class="pre">bridge</span> <span class="pre">two</span></code> du netns
du VPC. Trois chaînes de base (<code class="docutils literal notranslate"><span class="pre">prerouting</span></code>, <code class="docutils literal notranslate"><span class="pre">forward</span></code>, <code class="docutils literal notranslate"><span class="pre">output</span></code>) aiguillent chaque trame,
selon l’interface d’entrée ou de sortie, vers la chaîne du port concerné (<code class="docutils literal notranslate"><span class="pre">pre-&lt;port&gt;</span></code>,
<code class="docutils literal notranslate"><span class="pre">fwd-&lt;port&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">out-&lt;port&gt;</span></code>) par les tables <code class="docutils literal notranslate"><span class="pre">pre_ports</span></code>, <code class="docutils literal notranslate"><span class="pre">fwd_ports</span></code> et <code class="docutils literal notranslate"><span class="pre">out_ports</span></code>.
L’agent pose ou retire toutes les règles d’un port en une seule transaction. Les ports sont le
veth de chaque subnet (<code class="docutils literal notranslate"><span class="pre">v-&lt;subnet&gt;-i</span></code>, règles décrites plus haut) et le tap de chaque interface
de VM (<code class="docutils literal notranslate"><span class="pre">tap&lt;id&gt;</span></code>, chaîne <code class="docutils literal notranslate"><span class="pre">pre-tap&lt;id&gt;</span></code> : ce que la VM émet, voir
<a class="reference internal" href="vpc-subnet-vm.html"><span class="doc">VPC, subnet et VM</span></a>).</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Un subnet <code class="docutils literal notranslate"><span class="pre">bridge</span></code> créé par une version antérieure de l’agent n’a que la règle DHCP
@ -1054,6 +1066,7 @@ silencieusement.</p>
</ul>
</li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#bridge">bridge</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#regles-de-pont">Règles de pont</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#routes-annoncees-aux-vm">Routes annoncées aux VM</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#route-par-defaut-default-route-et-gateway">Route par défaut : <code class="docutils literal notranslate"><span class="pre">default_route</span></code> et <code class="docutils literal notranslate"><span class="pre">gateway</span></code></a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#pourquoi-la-route-32-vers-le-serveur-de-metadata-est-indispensable">Pourquoi la route <code class="docutils literal notranslate"><span class="pre">/32</span></code> vers le serveur de metadata est indispensable</a></li>

View file

@ -882,6 +882,28 @@ la route par défaut et le serveur de metadata. Tous les subnets d’une VM doiv
<p><strong>MAC.</strong> Chaque interface porte la MAC choisie par l’appelant, comme son IP. L’agent la donne
telle quelle à QEMU et à la réservation DHCP, sans en vérifier le format ni l’unicité : c’est à
l’appelant de garantir qu’elle est unique sur le segment L2.</p>
<p><strong>Filtrage.</strong> Chaque interface ne peut émettre que depuis sa propre MAC et sa propre IP. L’agent
pose sur son tap, avant de le créer, des règles qui rejettent toute trame émise par la VM :</p>
<ul class="simple">
<li><p>dont la MAC source n’est pas celle de l’interface ;</p></li>
<li><p>d’un autre type qu’IPv4, ARP ou IPv6 (une trame étiquetée VLAN par exemple) ;</p></li>
<li><p>ARP, dont la MAC ou l’adresse d’émetteur n’est pas celle de l’interface, sauf l’adresse
<code class="docutils literal notranslate"><span class="pre">0.0.0.0</span></code> d’une sonde de conflit d’adresse ;</p></li>
<li><p>IPv4, dont la source n’est pas l’adresse de l’interface, sauf <code class="docutils literal notranslate"><span class="pre">0.0.0.0</span></code> vers le port 67 (un
client DHCP qui n’a pas encore de bail) ;</p></li>
<li><p>réponse de serveur DHCP (UDP depuis le port 67).</p></li>
</ul>
<p>Une VM ne peut donc ni se faire passer pour la gateway ou une autre VM, ni distribuer de baux. Une
VM qui route pour d’autres machines ou porte des adresses supplémentaires ne peut pas émettre
depuis ces adresses. L’IPv6 n’est pas filtrée (#61). Les règles sont retirées après la suppression
du tap ; le watchdog signale une interface d’une VM <code class="docutils literal notranslate"><span class="pre">running</span></code> dont les règles manquent ou ont
été modifiées.</p>
<p><strong>Serveur DHCP.</strong> <code class="docutils literal notranslate"><span class="pre">dhcp_server:</span> <span class="pre">true</span></code> sur une interface lève le seul blocage des réponses DHCP,
pour cette interface. Cas d’usage : une VM d’un subnet <code class="docutils literal notranslate"><span class="pre">bridge</span></code> qui sert le DHCP et le PXE de
machines diskless du segment physique, avec des réservations statiques. Les autres contrôles
restent en place. L’agent applique ce champ quel que soit le mode du subnet : le réserver au mode
<code class="docutils literal notranslate"><span class="pre">bridge</span></code> revient à l’appelant. Le serveur de la VM reçoit aussi les requêtes des VM du subnet, à
côté du DHCP de l’agent : il ne doit répondre qu’aux machines qui lui sont destinées.</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

View file

@ -368,7 +368,7 @@ plan de contrôle — est traité à part : voir <a class="reference internal" h
<section id="prerequis">
<h2>Prérequis<a class="headerlink" href="#prerequis" title="Lien vers cette rubrique">#</a></h2>
<p>Un host Linux avec KVM, sur lequel vous avez <code class="docutils literal notranslate"><span class="pre">root</span></code>. Les opérations réseau (network
namespaces, netlink, VXLAN, ebtables, iptables) et QEMU ne fonctionnent que sous Linux.</p>
namespaces, netlink, VXLAN, nftables, iptables) et QEMU ne fonctionnent que sous Linux.</p>
</section>
<section id="deploiement">
<h2>Déploiement<a class="headerlink" href="#deploiement" title="Lien vers cette rubrique">#</a></h2>
@ -444,7 +444,7 @@ l’utiliser que pour diagnostiquer un manifeste cassé, jamais en déploiement
</section>
<section id="ce-que-fait-i">
<h2>Ce que fait <code class="docutils literal notranslate"><span class="pre">-i</span></code><a class="headerlink" href="#ce-que-fait-i" title="Lien vers cette rubrique">#</a></h2>
<p><strong>Paquets</strong> — <code class="docutils literal notranslate"><span class="pre">qemu-system-x86</span></code>, <code class="docutils literal notranslate"><span class="pre">qemu-utils</span></code>, <code class="docutils literal notranslate"><span class="pre">ovmf</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code>, <code class="docutils literal notranslate"><span class="pre">ebtables</span></code>,
<p><strong>Paquets</strong> — <code class="docutils literal notranslate"><span class="pre">qemu-system-x86</span></code>, <code class="docutils literal notranslate"><span class="pre">qemu-utils</span></code>, <code class="docutils literal notranslate"><span class="pre">ovmf</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code>, <code class="docutils literal notranslate"><span class="pre">nftables</span></code>,
<code class="docutils literal notranslate"><span class="pre">iptables</span></code>, <code class="docutils literal notranslate"><span class="pre">nfs-common</span></code>, <code class="docutils literal notranslate"><span class="pre">jq</span></code>, <code class="docutils literal notranslate"><span class="pre">curl</span></code>, <strong>sans les paquets recommandés</strong> : ceux de
<code class="docutils literal notranslate"><span class="pre">qemu-system-x86</span></code> (interface graphique, gtk, gstreamer, pilotes de stockage réseau) ne servent
pas à un hyperviseur sans écran, et l’installation passe d’environ 270 à 65 Mo — rejouée à chaque

View file

@ -716,9 +716,9 @@ code de sortie vaut 1 si une vérification échoue <strong>ou si aucune n’a é
<p><strong>Tests autonomes.</strong> Avant chaque test, le runner supprime les ressources <code class="docutils literal notranslate"><span class="pre">tNN</span></code> laissées par un
passage précédent, puis relève l’état de chaque hôte de l’en-tête <code class="docutils literal notranslate"><span class="pre">#</span> <span class="pre">hôtes:</span></code>. Après le test, il
supprime ses VM, ses subnets puis ses VPC, et vérifie que l’hôte est revenu à l’état relevé
(<code class="docutils literal notranslate"><span class="pre">assert_clean</span></code> : netns, liens, adresses, routes, règles ebtables et iptables, configuration FRR et
<code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>, fichiers de <code class="docutils literal notranslate"><span class="pre">/run/two</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq.d</span></code> et des volumes, unités <code class="docutils literal notranslate"><span class="pre">two-vm-*</span></code>,
processus dnsmasq et QEMU). Aucun test ne dépend d’un autre : n’importe lequel se lance seul.</p>
(<code class="docutils literal notranslate"><span class="pre">assert_clean</span></code> : netns, liens, adresses, routes, règles nftables de pont et iptables,
configuration FRR et <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>, fichiers de <code class="docutils literal notranslate"><span class="pre">/run/two</span></code>, <code class="docutils literal notranslate"><span class="pre">dnsmasq.d</span></code> et des volumes, unités
<code class="docutils literal notranslate"><span class="pre">two-vm-*</span></code>, processus dnsmasq et QEMU). Aucun test ne dépend d’un autre : n’importe lequel se lance seul.</p>
<p><strong>Plages.</strong> Le test <code class="docutils literal notranslate"><span class="pre">NN</span></code> nomme ses ressources <code class="docutils literal notranslate"><span class="pre">vp-tNN*</span></code>, <code class="docutils literal notranslate"><span class="pre">sn-tNN*</span></code> et <code class="docutils literal notranslate"><span class="pre">tNN-*</span></code>, et utilise
<code class="docutils literal notranslate"><span class="pre">10.NN.0.0/16</span></code> et les VNI <code class="docutils literal notranslate"><span class="pre">NN00</span></code> à <code class="docutils literal notranslate"><span class="pre">NN99</span></code> : aucune collision entre tests.</p>
<p><strong>Échecs connus.</strong> Un contrôle dont l’échec est connu et rattaché à un ticket s’écrit <code class="docutils literal notranslate"><span class="pre">known</span>
@ -745,7 +745,7 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#50, #51, #54, #41</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">02-prerequis</span></code></p></td>
<td><p>hypothèses d’environnement de la suite — firmware UEFI, unités modèles de l’agent, journalctl, format de ebtables -L, br-lan, priorités VRRP lues dans FRR</p></td>
<td><p>hypothèses d’environnement de la suite — firmware UEFI, unités modèles de l’agent, journalctl, format de nft list table, br-lan, priorités VRRP lues dans FRR</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#70</p></td>
</tr>
@ -815,9 +815,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#57, #41</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">33-bridge</span></code></p></td>
<td><p>subnet en mode bridge rattaché au bridge br-lan de l’hôte — un hôte, puis le même subnet sur deux hôtes (interface_ip confinée à son hôte : une seule réponse ARP, métadonnées servies par l’hôte de la VM, ni ARP ni DHCP de la gateway sur le segment, règles surveillées par le watchdog)</p></td>
<td><p>subnet en mode bridge rattaché au bridge br-lan de l’hôte — un hôte, puis le même subnet sur deux hôtes (interface_ip confinée à son hôte : une seule réponse ARP, métadonnées servies par l’hôte de la VM, ni ARP ni DHCP de la gateway sur le segment, règles surveillées par le watchdog) ; VM serveur DHCP des machines diskless (dhcp_server) entendue sur le segment, voisine bloquée</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#70, #75</p></td>
<td><p>#70, #75, #76</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">34-isolation-locale</span></code></p></td>
<td><p>isolation entre deux VPC sur un même hôte — ni ICMP ni TCP d’un VPC à l’autre</p></td>
@ -825,9 +825,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#50</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">35-filtrage-port</span></code></p></td>
<td><p>filtrage au port — en sortie vers le fabric (v-&lt;id&gt;-i) : ARP vers la gateway et l’adresse d’émission, DHCP émis depuis ces adresses, MAC anycast confinée dans les deux sens ; entre VM d’un même hôte : faux serveur DHCP et usurpation ARP de la gateway (comportement attendu, non filtré à ce jour)</p></td>
<td><p>filtrage au port — en sortie vers le fabric (v-&lt;id&gt;-i) : ARP vers la gateway et l’adresse d’émission, DHCP émis depuis ces adresses, MAC anycast confinée dans les deux sens ; à la sortie de chaque VM (pre-tap&lt;id&gt;) : MAC, IP et ARP usurpés, faux serveur DHCP, source 0.0.0.0 hors DHCP, type de trame non IP, NIC autorisée en serveur DHCP (dhcp_server), règles surveillées par le watchdog et retirées avec la VM</p></td>
<td><p>hv1</p></td>
<td><p>#57</p></td>
<td><p>#57, #76</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">41-evpn-l2</span></code></p></td>
<td><p>subnet vxlan étendu entre deux hôtes par EVPN — VTEP local, VTEP distant et inondation appris, MAC des VM en type 2, trafic ICMP et TCP, MTU 1500 de bout en bout</p></td>
@ -912,7 +912,6 @@ attend jusqu’à 480 s, au-delà du <code class="docutils literal notranslate">
<li><p>systemd-networkd <strong>ne réécrit pas</strong> un bail renouvelé à l’identique : un renouvellement se
vérifie par le DHCPACK dans le journal du serveur (<code class="docutils literal notranslate"><span class="pre">lease_renewed</span></code>), pas par le fichier de bail ;</p></li>
<li><p>l’agent n’accepte <strong>qu’un seul disque virtio</strong> (le disque racine, <code class="docutils literal notranslate"><span class="pre">vda</span></code>) ; les autres sont des <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> ;</p></li>
<li><p>sur Debian 12, <code class="docutils literal notranslate"><span class="pre">ebtables</span> <span class="pre">-L</span></code> (nft) garde les zéros de tête des MAC ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> est posée en <code class="docutils literal notranslate"><span class="pre">/32</span></code> sur le bridge du netns en mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> ;</p></li>
<li><p>depuis le netns d’un hôte, une VM d’un autre hôte ne répond pas : la réponse repart vers la
gateway de son propre hôte. Une vérification entre hôtes passe par une VM.</p></li>
@ -934,7 +933,7 @@ Chaque bloc est précédé des bibliothèques de <code class="docutils literal n
<code class="docutils literal notranslate"><span class="pre">user_data</span></code>, mot de passe), SSH, bail, métadonnées. La MAC de chaque NIC est fournie à l’API :
<code class="docutils literal notranslate"><span class="pre">52:54:00</span></code> suivi des trois derniers octets de l’IP (<code class="docutils literal notranslate"><span class="pre">mac_for_ip</span></code>), unique dans la suite
puisque chaque test a sa plage ; <code class="docutils literal notranslate"><span class="pre">--nic</span> <span class="pre">sn=ip=mac</span></code> en impose une autre ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">net.sh</span></code> : VPC, subnets, MAC anycast, trames brutes, règles ebtables, VRRP ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">net.sh</span></code> : VPC, subnets, MAC anycast, trames brutes, règles nftables, VRRP ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">evpn.sh</span></code> : VRF, BGP, L3VNI, watchdog ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">fixture.sh</span></code> : nettoyage et <code class="docutils literal notranslate"><span class="pre">assert_clean</span></code>, appelés par le runner. Le nettoyage couvre les
ressources <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;</span></code> de l’API, les netns <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;-*</span></code> et les fichiers <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;-*</span></code> / <code class="docutils literal notranslate"><span class="pre">t&lt;NN&gt;.*</span></code> de

View file

@ -617,7 +617,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="nt">"subnet"</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">"ip"</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">"mac"</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">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="p">],</span>
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
@ -671,7 +672,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="nt">"subnet"</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">"ip"</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">"mac"</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">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="p">],</span>
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
@ -703,7 +705,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="nt">"subnet"</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">"ip"</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">"mac"</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">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="p">],</span>
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
@ -801,7 +804,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="nt">"subnet"</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">"ip"</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">"mac"</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">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="p">],</span>
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
@ -870,7 +874,8 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
<span class="w"> </span><span class="nt">"subnet"</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">"ip"</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">"mac"</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">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="nt">"primary"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"dhcp_server"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="p">],</span>
<span class="w"> </span><span class="nt">"storage"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>

View file

@ -346,6 +346,7 @@
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-ressource-part-en-error-juste-apres-le-202">La ressource part en <code class="docutils literal notranslate"><span class="pre">error</span></code> juste après le 202</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-demarre-mais-n-a-pas-d-adresse">La VM démarre mais n’a pas d’adresse</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-ne-joint-pas-sa-gateway-subnet-vxlan">La VM ne joint pas sa gateway (subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>)</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#une-vm-n-arrive-pas-a-emettre-certaines-trames">Une VM n’arrive pas à émettre certaines trames</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-a-une-adresse-mais-cloud-init-n-applique-rien">La VM a une adresse mais cloud-init n’applique rien</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#le-user-data-est-servi-vide">Le user-data est servi vide</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-ne-demarre-pas-uefi">La VM ne démarre pas (UEFI)</a></li>
@ -433,9 +434,8 @@ ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</sp
<span class="c1"># route du subnet émise depuis la gateway</span>
ip<span class="w"> </span>-n<span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>-4<span class="w"> </span>route<span class="w"> </span>show<span class="w"> </span>dev<span class="w"> </span>br-&lt;subnet&gt;
<span class="c1"># confinement : source anycast rejetée sur le veth du subnet</span>
ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>ebtables<span class="w"> </span>-t<span class="w"> </span>nat<span class="w"> </span>-L<span class="w"> </span>PREROUTING
ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>ebtables<span class="w"> </span>-L<span class="w"> </span>FORWARD
<span class="c1"># confinement : chaînes pre-, fwd- et out-v-&lt;subnet&gt;-i, source anycast rejetée</span>
ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>nft<span class="w"> </span>list<span class="w"> </span>table<span class="w"> </span>bridge<span class="w"> </span>two
</pre></div>
</div>
<p>Dans le guest, <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">neigh</span> <span class="pre">show</span> <span class="pre">&lt;gateway&gt;</span></code> doit montrer la MAC <code class="docutils literal notranslate"><span class="pre">02:01:00:&lt;VNI&gt;</span></code>. Une autre MAC —
@ -445,6 +445,21 @@ gateway posée sur le bridge.</p>
<code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">netns</span> <span class="pre">exec</span> <span class="pre">&lt;vpc&gt;</span> <span class="pre">ping</span> <span class="pre">-I</span> <span class="pre">&lt;relay_ip&gt;</span> <span class="pre">&lt;ip&gt;</span></code>. Un ping sans <code class="docutils literal notranslate"><span class="pre">-I</span></code> part de la gateway et la
réponse revient à l’hôte de la VM — ce n’est pas une panne.</p>
</section>
<section id="une-vm-n-arrive-pas-a-emettre-certaines-trames">
<h2>Une VM n’arrive pas à émettre certaines trames<a class="headerlink" href="#une-vm-n-arrive-pas-a-emettre-certaines-trames" title="Lien vers cette rubrique">#</a></h2>
<p>Le filtrage du tap rejette ce qu’une interface émet depuis une autre MAC ou une autre IP que les
siennes, l’ARP usurpé, les réponses DHCP et les trames d’un autre type qu’IPv4, ARP ou IPv6
(<a class="reference internal" href="../concepts/vpc-subnet-vm.html"><span class="doc">VPC, subnet et VM</span></a>). Causes rencontrées : une VM qui route pour d’autres machines,
porte une adresse supplémentaire, envoie des trames étiquetées VLAN, ou sert le DHCP sans
<code class="docutils literal notranslate"><span class="pre">dhcp_server:</span> <span class="pre">true</span></code> sur son interface. Ce n’est pas une panne : le filtrage est voulu.</p>
<p>Retrouver la chaîne d’une interface par sa MAC, puis lire ses règles :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>nft<span class="w"> </span>list<span class="w"> </span>table<span class="w"> </span>bridge<span class="w"> </span>two<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-B1<span class="w"> </span><span class="s1">'ether saddr != &lt;mac&gt; drop'</span>
ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>nft<span class="w"> </span>list<span class="w"> </span>chain<span class="w"> </span>bridge<span class="w"> </span>two<span class="w"> </span>pre-tap&lt;id&gt;
</pre></div>
</div>
<p>Une chaîne absente, ou une interface absente de <code class="docutils literal notranslate"><span class="pre">pre_ports</span></code>, laisse la VM émettre sans filtre :
le watchdog le signale (<code class="docutils literal notranslate"><span class="pre">interface</span> <span class="pre">&lt;i&gt;:</span> <span class="pre">nftables</span> <span class="pre">rule</span> <span class="pre">missing</span></code>). Recréer la VM repose ses règles.</p>
</section>
<section id="la-vm-a-une-adresse-mais-cloud-init-n-applique-rien">
<h2>La VM a une adresse mais cloud-init n’applique rien<a class="headerlink" href="#la-vm-a-une-adresse-mais-cloud-init-n-applique-rien" title="Lien vers cette rubrique">#</a></h2>
<p>Deux causes distinctes, à écarter dans cet ordre.</p>
@ -567,6 +582,7 @@ l’agent n’est plus piloté par lui.</p>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-ressource-part-en-error-juste-apres-le-202">La ressource part en <code class="docutils literal notranslate"><span class="pre">error</span></code> juste après le 202</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-demarre-mais-n-a-pas-d-adresse">La VM démarre mais n’a pas d’adresse</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-ne-joint-pas-sa-gateway-subnet-vxlan">La VM ne joint pas sa gateway (subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code>)</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#une-vm-n-arrive-pas-a-emettre-certaines-trames">Une VM n’arrive pas à émettre certaines trames</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-a-une-adresse-mais-cloud-init-n-applique-rien">La VM a une adresse mais cloud-init n’applique rien</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#le-user-data-est-servi-vide">Le user-data est servi vide</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#la-vm-ne-demarre-pas-uefi">La VM ne démarre pas (UEFI)</a></li>

File diff suppressed because one or more lines are too long