docs: build de d070f99b97
This commit is contained in:
parent
88d5b278a3
commit
edeb124501
10 changed files with 91 additions and 32 deletions
|
|
@ -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<id></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>
|
||||
|
|
|
|||
|
|
@ -379,6 +379,7 @@ vm/<name>/nic/<i>/subnet → <subnet-name> (une interfac
|
|||
vm/<name>/nic/<i>/ip → <ip>
|
||||
vm/<name>/nic/<i>/mac → <mac> (fournie par l'appelant, conservée telle quelle)
|
||||
vm/<name>/nic/<i>/primary → "true" (exactement une interface ; absent sur les autres)
|
||||
vm/<name>/nic/<i>/dhcp_server → "true" (absent si l'interface ne sert pas le DHCP)
|
||||
vm/<name>/nic/<i>/tap_id → <int> (alloué au premier démarrage, puis conservé)
|
||||
vm/<name>/metadata_port → <port>
|
||||
vm/<name>/disk/<dev> → <path> (une clé par disque : vda, xvda, xvdb, …)
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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-<subnet>-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-<port></span></code>,
|
||||
<code class="docutils literal notranslate"><span class="pre">fwd-<port></span></code>, <code class="docutils literal notranslate"><span class="pre">out-<port></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-<subnet>-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<id></span></code>, chaîne <code class="docutils literal notranslate"><span class="pre">pre-tap<id></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>
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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-<id>-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-<id>-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<id>) : 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<NN></span></code> de l’API, les netns <code class="docutils literal notranslate"><span class="pre">t<NN>-*</span></code> et les fichiers <code class="docutils literal notranslate"><span class="pre">t<NN>-*</span></code> / <code class="docutils literal notranslate"><span class="pre">t<NN>.*</span></code> de
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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><vpc><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-<subnet>
|
||||
|
||||
<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><vpc><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><vpc><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-<subnet>-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><vpc><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"><gateway></span></code> doit montrer la MAC <code class="docutils literal notranslate"><span class="pre">02:01:00:<VNI></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"><vpc></span> <span class="pre">ping</span> <span class="pre">-I</span> <span class="pre"><relay_ip></span> <span class="pre"><ip></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><vpc><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 != <mac> drop'</span>
|
||||
ip<span class="w"> </span>netns<span class="w"> </span><span class="nb">exec</span><span class="w"> </span><vpc><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<id>
|
||||
</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"><i>:</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
Loading…
Add table
Add a link
Reference in a new issue