This commit is contained in:
forgejo-actions 2026-10-12 11:08:03 +00:00
commit cedb387889
5 changed files with 61 additions and 25 deletions

View file

@ -404,46 +404,56 @@ une erreur.</p>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/vpc</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/subnet</span></code></p></td>
<td><p>création et suppression bas niveau (netns + netif)</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netns</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/l3vni</span></code></p></td>
<td><p>routage d’une VPC par L3VNI : VRF, L3VNI, transit, configuration FRR, export des routes
<code class="docutils literal notranslate"><span class="pre">/24</span></code> et <code class="docutils literal notranslate"><span class="pre">/32</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/frr</span></code></p></td>
<td><p>génération des commandes FRR, seul point d’appel à <code class="docutils literal notranslate"><span class="pre">vtysh</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/sysctl</span></code></p></td>
<td><p>écriture sous <code class="docutils literal notranslate"><span class="pre">/proc/sys</span></code>, dans un netns si besoin</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netns</span></code></p></td>
<td><p>network namespaces : create/enter/delete/call</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netif</span></code></p></td>
<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-odd"><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/ebtables</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-even"><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>
<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>
<td><p>lancement de QEMU et client QMP sur socket Unix</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/vm</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/vm</span></code></p></td>
<td><p>cycle de vie d’une VM : tap, iptables, metadata, qemu</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcp</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcp</span></code></p></td>
<td><p>plan d’adressage ip → mac, et configurations dnsmasq du backend historique</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/metadata</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/metadata</span></code></p></td>
<td><p>serveur de metadata cloud-init et ses templates</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog</span></code></p></td>
<td><p>vérification périodique en lecture seule</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/config/agent</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/config/agent</span></code></p></td>
<td><p>chargement par viper — tags <code class="docutils literal notranslate"><span class="pre">mapstructure</span></code>, jamais <code class="docutils literal notranslate"><span class="pre">yaml</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/prometheus/agent</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/prometheus/agent</span></code></p></td>
<td><p>collector des métriques <code class="docutils literal notranslate"><span class="pre">syonad_*</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/kv</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/kv</span></code></p></td>
<td><p>wrapper Badger ; toutes les valeurs sont des chaînes plates</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/worker</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/worker</span></code></p></td>
<td><p>pool de goroutines sur canal</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/systemd</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/systemd</span></code></p></td>
<td><p>client D-Bus systemd</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/logger</span></code>, <code class="docutils literal notranslate"><span class="pre">pkg/prometheus</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/logger</span></code>, <code class="docutils literal notranslate"><span class="pre">pkg/prometheus</span></code></p></td>
<td><p>journalisation <code class="docutils literal notranslate"><span class="pre">slog</span></code> et serveur de métriques</p></td>
</tr>
</tbody>

View file

@ -522,7 +522,10 @@ livré le 2026-10-11 un E5-2670 de 2012, x86-64-v2, sur lequel Rocky 10 ne déma
<code class="docutils literal notranslate"><span class="pre">prepare</span></code> refuse donc un serveur sans x86-64-v3 — dans une <code class="docutils literal notranslate"><span class="pre">session</span></code>, il est aussitôt
supprimé. La zone n’est pas imposée : <code class="docutils literal notranslate"><span class="pre">plan</span></code> et <code class="docutils literal notranslate"><span class="pre">up</span></code> prennent la première zone de
<code class="docutils literal notranslate"><span class="pre">LAB_ZONES</span></code> (par défaut toutes les zones Elastic Metal) où l’offre est en stock, <code class="docutils literal notranslate"><span class="pre">SCW_DEFAULT_ZONE</span></code>
passant en tête ; <code class="docutils literal notranslate"><span class="pre">status</span></code> et <code class="docutils literal notranslate"><span class="pre">down</span></code> couvrent toutes ces zones.</p>
passant en tête ; <code class="docutils literal notranslate"><span class="pre">status</span></code> et <code class="docutils literal notranslate"><span class="pre">down</span></code> couvrent toutes ces zones. Une zone dont la liste échoue
est signalée sans masquer les autres : <code class="docutils literal notranslate"><span class="pre">status</span></code> affiche ce qui a répondu, <code class="docutils literal notranslate"><span class="pre">down</span></code> supprime les
serveurs listés, et tous deux sortent en erreur ; <code class="docutils literal notranslate"><span class="pre">up</span></code> refuse de créer tant qu’une zone reste
inconnue.</p>
<p><code class="docutils literal notranslate"><span class="pre">session</span></code> est la forme normale d’usage : le serveur est supprimé à la fin, que la commande
réussisse, échoue, ou que la session soit interrompue (Ctrl-C, <code class="docutils literal notranslate"><span class="pre">TERM</span></code>, fermeture du terminal).</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ scripts/lab-host.sh session 'uname -a; lscpu | grep -E "Model name|^CPU\(s\)|Virtualization"; free -g | head -2; echo "nested=$(cat /sys/module/kvm_intel/parameters/nested)"; ls -l /dev/kvm'
@ -597,11 +600,11 @@ portés par un switch). Exemple livré, <code class="docutils literal notranslat
<span class="nt"> loopback</span><span class="p">:</span><span class="w"> </span><span class="nv">10.255.255.1/32</span><span class="p p-Indicator">,</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/rr1.conf</span><span class="w"> </span><span class="p p-Indicator">}</span>
<span class="w"> </span><span class="nt">hv1</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">hypervisor</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.11</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv1.conf</span><span class="p p-Indicator">,</span><span class="nt"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc005</span><span class="p p-Indicator">,</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.11</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv1.conf</span><span class="p p-Indicator">,</span><span class="nt"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc006</span><span class="p p-Indicator">,</span>
<span class="nt"> agent</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/two.yml</span><span class="w"> </span><span class="p p-Indicator">}</span>
<span class="w"> </span><span class="nt">hv2</span><span class="p">:</span>
<span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> role</span><span class="p">:</span><span class="w"> </span><span class="nv">hypervisor</span><span class="p p-Indicator">,</span><span class="nt"> image</span><span class="p">:</span><span class="w"> </span><span class="nv">debian12</span><span class="p p-Indicator">,</span><span class="nt"> cpus</span><span class="p">:</span><span class="w"> </span><span class="nv">4</span><span class="p p-Indicator">,</span><span class="nt"> memory</span><span class="p">:</span><span class="w"> </span><span class="nv">16384</span><span class="p p-Indicator">,</span><span class="nt"> segments</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">underlay</span><span class="p p-Indicator">],</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.12</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv2.conf</span><span class="p p-Indicator">,</span><span class="nt"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc005</span><span class="p p-Indicator">,</span>
<span class="nt"> addresses</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">{</span><span class="nt"> underlay</span><span class="p">:</span><span class="w"> </span><span class="nv">192.168.14.12</span><span class="w"> </span><span class="p p-Indicator">},</span><span class="nt"> frr</span><span class="p">:</span><span class="w"> </span><span class="nv">frr/hv2.conf</span><span class="p p-Indicator">,</span><span class="nt"> release</span><span class="p">:</span><span class="w"> </span><span class="nv">0.2.0rc006</span><span class="p p-Indicator">,</span>
<span class="nt"> agent</span><span class="p">:</span><span class="w"> </span><span class="nv">agent/bgp.yml</span><span class="w"> </span><span class="p p-Indicator">}</span>
</pre></div>
</div>
@ -632,7 +635,7 @@ segment ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">frr</span></code> — le chemin d’un <code class="docutils literal notranslate"><span class="pre">frr.conf</span></code>, relatif au fichier de topologie : FRR est installé
au démarrage et la configuration déposée <strong>telle quelle</strong> (voir <a class="reference internal" href="#roles">Rôles</a>).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">release</span></code> — <strong>obligatoire pour un hyperviseur</strong>, refusé ailleurs : le tag de la release de
two que <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> installe (<code class="docutils literal notranslate"><span class="pre">release:</span> <span class="pre">0.2.0rc005</span></code>). Sans lui, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> prendrait la
two que <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> installe (<code class="docutils literal notranslate"><span class="pre">release:</span> <span class="pre">0.2.0rc006</span></code>). Sans lui, <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code> prendrait la
dernière release, et le lab ne serait plus reproductible.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">agent</span></code> — pour un hyperviseur seulement : le chemin d’un <code class="docutils literal notranslate"><span class="pre">agent.yml</span></code>, relatif au fichier
de topologie, déposé dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code> avant <code class="docutils literal notranslate"><span class="pre">deploy.sh</span></code>. Sans lui, l’agent tourne
@ -696,8 +699,8 @@ roles
name loopback secondary frr release agent
sw1 - underlay 169.254.0.1/28 sw1.conf - -
rr1 lo1 10.255.255.1/32 underlay 169.254.0.3/28 rr1.conf - -
hv1 - - hv1.conf 0.2.0rc005 two.yml
hv2 - - hv2.conf 0.2.0rc005 bgp.yml
hv1 - - hv1.conf 0.2.0rc006 two.yml
hv2 - - hv2.conf 0.2.0rc006 bgp.yml
segment underlay: 192.168.14.0/24, mtu 9000, switch sw1, bridge br-underlay, gateway 192.168.14.1
node interface address mac udp switch port mac udp
@ -1217,6 +1220,13 @@ chaque hôte, sans doublon EVPN ; watchdog : <code class="docutils literal notra
signalé</p></td>
<td><p>hv1, hv2, hv3, rr1</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">s9-subnets-partages</span></code></p></td>
<td><p>deux VPC, avec et sans <code class="docutils literal notranslate"><span class="pre">l3vni</span></code>, chacune avec deux subnets présents sur <strong>les deux</strong>
hyperviseurs et une VM par subnet et par hôte : ping entre toutes les paires (même subnet ou
non, même hôte ou non) ; chaque VM voit la MAC de gateway de son propre hôte ; aucune MAC en
double sur les quatre VNI</p></td>
<td><p>hv2, hv3, rr1</p></td>
</tr>
</tbody>
</table>
</div>
@ -1305,6 +1315,20 @@ inconnue, refus) sort en 1.</p></li>
<li><p><strong>L3VNI libérée de façon asynchrone</strong> : juste après <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">vni</span></code>, <code class="docutils literal notranslate"><span class="pre">no</span> <span class="pre">router</span> <span class="pre">bgp</span> <span class="pre">…</span> <span class="pre">vrf</span></code> peut être
refusé (« Please unconfigure l3vni ») puis accepté un instant plus tard ; l’agent réessaie.</p></li>
</ul>
<p>Le 2026-10-12, release <code class="docutils literal notranslate"><span class="pre">0.2.0rc006</span></code>, <code class="docutils literal notranslate"><span class="pre">evpn-3hv.yml</span></code> : <code class="docutils literal notranslate"><span class="pre">s1</span></code> à <code class="docutils literal notranslate"><span class="pre">s7</span></code> sans échec,
<code class="docutils literal notranslate"><span class="pre">s8-l3vni-migration</span></code> <strong>50 réussi(s), 0 échoué(s)</strong> (MAC de gateway propre à chaque hôte, aucun
doublon EVPN), <code class="docutils literal notranslate"><span class="pre">s9-subnets-partages</span></code> <strong>75 réussi(s), 1 échoué(s)</strong>. L’échec est une session SSH
coupée (<code class="docutils literal notranslate"><span class="pre">Broken</span> <span class="pre">pipe</span></code>), pas un ping perdu : quand un hôte route vers une VM d’un autre hôte, son
netns émet une requête ARP au nom de la gateway, partagée par tous les hôtes ; la VM met son cache à
jour et, pendant ~8 s, envoie à la gateway de l’autre hôte ce qui était destiné à la sienne.
Détails et suite : <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/57">#57</a>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Un <code class="docutils literal notranslate"><span class="pre">Broken</span> <span class="pre">pipe</span></code> (<code class="docutils literal notranslate"><span class="pre">client_loop:</span> <span class="pre">send</span> <span class="pre">disconnect</span></code>) ou une session SSH figée dans un scénario
n’est <strong>pas forcément un aléa du lab</strong> : c’est la signature de ce problème. Ne pas le classer
comme test instable ni ajouter un nouvel essai qui le masquerait ; regarder d’abord le cache ARP
de la VM (<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>) et l’état de la session côté VM.</p>
</div>
<p>Les VM sont accessibles depuis le netns de leur VPC, sur l’hyperviseur, avec l’utilisateur
<code class="docutils literal notranslate"><span class="pre">syonad</span></code> créé par les métadonnées de two :</p>
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>scripts/lab-host.sh ssh "./lab ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'"

View file

@ -412,7 +412,8 @@ de VM et la réponse des units systemd associées.</p>
le propriétaire n’existe plus — ni <code class="docutils literal notranslate"><span class="pre">running</span></code>, ni en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> —
est signalée comme un <strong>trou noir</strong> : l’annonce attire du trafic que plus rien ne reçoit.</p></li>
</ul>
<p>Un VPC routé alors que la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> a disparu de la configuration est signalé lui aussi.</p>
<p>Un VPC routé alors que la section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> a disparu de la configuration est signalé lui aussi. Il
reste supprimable : le démontage lit l’AS de son instance dans la configuration courante de FRR.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Un écart persistant est signalé <strong>à chaque tick</strong>, sans déduplication. Le volume de

File diff suppressed because one or more lines are too long

View file

@ -393,9 +393,10 @@ subnet déjà créé reste servi par le serveur qui l’a été. La procédure e
</ul>
<p><strong>Routage inter-subnet entre hyperviseurs : L3VNI (#41)</strong></p>
<ul class="simple">
<li><p>Nouveau champ facultatif <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> sur <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vpcs</span></code> (1 à 16777215, sauf 253-255 : c’est aussi
l’identifiant de la table de routage). Absent, le VPC se comporte comme avant. Une L3VNI déjà
portée par un VPC de l’agent est refusée (409), comme un <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandé sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code></p></li>
<li><p>Nouveau champ facultatif <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> sur <code class="docutils literal notranslate"><span class="pre">POST</span> <span class="pre">/vpcs</span></code> (1 à 65535, sauf 253-255 : c’est aussi
l’identifiant de la table de routage, et le numéro du RD <code class="docutils literal notranslate"><span class="pre">&lt;VTEP&gt;:&lt;l3vni&gt;</span></code>, sur 16 bits).
Absent, le VPC se comporte comme avant. Une L3VNI déjà portée par un VPC de l’agent est refusée
(409), comme un <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandé sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code></p></li>
<li><p>Pour un VPC routé, l’agent pose sur l’hyperviseur une VRF (table = L3VNI), un bridge à la MAC de
routeur <code class="docutils literal notranslate"><span class="pre">02:02:&lt;IPv4</span> <span class="pre">du</span> <span class="pre">VTEP&gt;</span></code>, le VXLAN de la L3VNI, un lien de transit <code class="docutils literal notranslate"><span class="pre">169.254.0.1/30</span></code> ↔
<code class="docutils literal notranslate"><span class="pre">169.254.0.2/30</span></code> vers le netns et la route du <code class="docutils literal notranslate"><span class="pre">cidr</span></code> du VPC dans le netns ; FRR reçoit la VRF,