This commit is contained in:
forgejo-actions 2026-10-31 19:16:38 +00:00
commit 3a7372b546
12 changed files with 249 additions and 70 deletions

View file

@ -415,66 +415,69 @@ une erreur.</p>
<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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/host</span></code></p></td>
<td><p>connaissance de l’hôte : faits lus au démarrage (<code class="docutils literal notranslate"><span class="pre">/register</span></code>), état mesuré périodiquement en mémoire (<code class="docutils literal notranslate"><span class="pre">/ping</span></code>)</p></td>
</tr>
<tr class="row-even"><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>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netns</span></code></p></td>
<td><p>network namespaces : create/delete/call</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/netif</span></code></p></td>
<tr class="row-even"><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/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 class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/nft</span></code></p></td>
<td><p>wrapper dédié ; ne pas appeler <code class="docutils literal notranslate"><span class="pre">nft</span></code> 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>
<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>
<td><p>lancement de QEMU et client QMP sur socket Unix</p></td>
</tr>
<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 class="row-odd"><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, nftables, metadata, qemu</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcp</span></code></p></td>
<tr class="row-even"><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-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpbackend</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpbackend</span></code></p></td>
<td><p>interface commune aux deux backends DHCP (<code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> et <code class="docutils literal notranslate"><span class="pre">two</span></code>), choisie par
<code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpd</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/dhcpd</span></code></p></td>
<td><p>moteur du serveur DHCP intégré : réservations en mémoire, réponses, écoute</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/api/dhcp</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/client/dhcp</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/api/dhcp</span></code>, <code class="docutils literal notranslate"><span class="pre">internal/client/dhcp</span></code></p></td>
<td><p>protocole de la socket de contrôle du serveur DHCP intégré (<code class="docutils literal notranslate"><span class="pre">set-host</span></code>, <code class="docutils literal notranslate"><span class="pre">probe</span></code>,
<code class="docutils literal notranslate"><span class="pre">get-state</span></code>…), côté serveur et côté agent</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/watchdog/notify</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/watchdog/notify</span></code></p></td>
<td><p>émission des écarts relevés par le watchdog (journal)</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">internal/config/agent</span></code></p></td>
<tr class="row-odd"><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-odd"><td><p><code class="docutils literal notranslate"><span class="pre">internal/prometheus/agent</span></code></p></td>
<tr class="row-even"><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-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/kv</span></code></p></td>
<tr class="row-odd"><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-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">pkg/db/statefile</span></code></p></td>
<td><p>fichier d’état JSON typé, écrit de façon atomique, utilisé par le backend DHCP <code class="docutils literal notranslate"><span class="pre">two</span></code></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

@ -807,17 +807,17 @@ VRF du VPC et l’hôte.</p>
<h2>Chemin d’une requête<a class="headerlink" href="#chemin-d-une-requete" title="Lien vers cette rubrique">#</a></h2>
<pre class="mermaid">
graph LR
V[&quot;VM&lt;br/&gt;vers interface_ip:53 ou :123&quot;] --&gt; N[&quot;netns du VPC&lt;br/&gt;chaîne TWO-HOSTSVC&lt;br/&gt;DNAT vers 169.254.169.253&quot;]
V[&quot;VM&lt;br/&gt;vers interface_ip:53 ou :123&quot;] --&gt; N[&quot;netns du VPC&lt;br/&gt;chaîne nftables hostsvc&lt;br/&gt;DNAT vers 169.254.169.253&quot;]
N --&gt; H[&quot;two-hostsvc&lt;br/&gt;socket dans le netns&lt;br/&gt;169.254.169.253 sur la dummy hostsvc&quot;]
H --&gt;|&quot;depuis l'hôte&quot;| U[&quot;serveurs amont&lt;br/&gt;puis résolveur ou horloge de l'hôte&quot;]
</pre><p>À la création d’un VPC sur l’hyperviseur, l’agent pose dans son netns :</p>
<ul class="simple">
<li><p>une interface <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> portant <code class="docutils literal notranslate"><span class="pre">169.254.169.253/32</span></code> ;</p></li>
<li><p>une chaîne iptables <code class="docutils literal notranslate"><span class="pre">TWO-HOSTSVC</span></code> (table <code class="docutils literal notranslate"><span class="pre">nat</span></code>), appelée depuis <code class="docutils literal notranslate"><span class="pre">PREROUTING</span></code> pour le seul
trafic à destination d’une adresse locale du netns (<code class="docutils literal notranslate"><span class="pre">addrtype</span> <span class="pre">LOCAL</span></code> : les gateways des
subnets, anycast compris). Elle renvoie d’abord ce qui arrive par <code class="docutils literal notranslate"><span class="pre">br-public</span></code> (le segment
public de l’hôte) et par <code class="docutils literal notranslate"><span class="pre">l3-+</span></code> (le lien vers la VRF), puis redirige 53 en UDP et TCP et 123
en UDP vers <code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code> ;</p></li>
<li><p>une chaîne nftables <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> dans la table <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code>, accrochée à <code class="docutils literal notranslate"><span class="pre">prerouting</span></code> en
priorité <code class="docutils literal notranslate"><span class="pre">dstnat</span></code>. Elle renvoie d’abord ce qui arrive par <code class="docutils literal notranslate"><span class="pre">br-public</span></code> (le segment public de
l’hôte) et par <code class="docutils literal notranslate"><span class="pre">l3-*</span></code> (le lien vers la VRF), puis redirige 53 en UDP et TCP et 123 en UDP vers
<code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code>, pour le seul trafic à destination d’une adresse locale du netns
(<code class="docutils literal notranslate"><span class="pre">fib</span> <span class="pre">daddr</span> <span class="pre">type</span> <span class="pre">local</span></code> : les gateways des subnets, anycast compris) ;</p></li>
</ul>
<p>puis demande à <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> d’ouvrir ses sockets dans ce netns. La réponse repart par
conntrack, avec l’adresse de la gateway pour source. Une VM qui interroge un résolveur extérieur

View file

@ -829,7 +829,7 @@ reçoivent du trafic. Il désactive aussi <code class="docutils literal notransl
(<code class="docutils literal notranslate"><span class="pre">net.bridge.bridge-nf-call-{iptables,ip6tables,arptables}=0</span></code>, quand le module est chargé) : sinon
conntrack voit chaque trame pontée et le SNAT de la passerelle NAT ne s’applique plus.</p>
<p>Dans le netns, l’agent pose aussi la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> (<code class="docutils literal notranslate"><span class="pre">169.254.169.253/32</span></code>) et la chaîne
iptables <code class="docutils literal notranslate"><span class="pre">TWO-HOSTSVC</span></code>, puis demande à <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> de servir le VPC : c’est le chemin du
nftables <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> (table <code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code>), puis demande à <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> de servir le VPC : c’est le chemin du
DNS et du NTP des VM (voir <a class="reference internal" href="dns-ntp.html"><span class="doc">DNS et NTP des VM</span></a>). Si <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> ne répond pas, la création du VPC
échoue.</p>
<p>Un VPC ne peut être supprimé que si tous ses subnets le sont déjà — sinon 409.</p>

View file

@ -371,7 +371,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, nftables, iptables) et QEMU ne fonctionnent que sous Linux.</p>
namespaces, netlink, VXLAN, nftables) 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>
@ -452,7 +452,7 @@ l’utiliser que pour diagnostiquer un manifeste cassé, jamais en déploiement
<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">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">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
démarrage, la racine étant en tmpfs. <code class="docutils literal notranslate"><span class="pre">qemu-utils</span></code> est demandé explicitement : <code class="docutils literal notranslate"><span class="pre">qemu-img</span></code> sert
@ -462,10 +462,11 @@ dans les netns.</p>
<p><code class="docutils literal notranslate"><span class="pre">dnsmasq</span></code> reste installé bien que <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> vaille <code class="docutils literal notranslate"><span class="pre">two</span></code> par défaut : le paquet sert
aux hyperviseurs qui déclarent <code class="docutils literal notranslate"><span class="pre">dhcp.backend:</span> <span class="pre">dnsmasq</span></code>, et tant qu’un hyperviseur peut revenir
en arrière. Voir <a class="reference internal" href="../exploitation/configuration.html"><span class="doc">Configuration</span></a>.</p>
<p><strong>Noyau</strong> — chargement de <code class="docutils literal notranslate"><span class="pre">br_netfilter</span></code>, puis <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span> <span class="pre">=</span> <span class="pre">1</span></code> et
<code class="docutils literal notranslate"><span class="pre">net.bridge.bridge-nf-call-iptables</span> <span class="pre">=</span> <span class="pre">1</span></code>. Cette dernière clé est <strong>requise</strong> par la DNAT vers
le serveur de metadata : sans elle, iptables ne voit pas le trafic bridgé des VM et cloud-init
ne se provisionne pas. Contrepartie assumée : tout le trafic inter-VM traverse les tables NAT.</p>
<p><strong>Noyau</strong> — <code class="docutils literal notranslate"><span class="pre">net.ipv4.ip_forward</span> <span class="pre">=</span> <span class="pre">1</span></code>. <code class="docutils literal notranslate"><span class="pre">br_netfilter</span></code> n’est pas chargé : le filtrage des
ponts est en nftables (famille <code class="docutils literal notranslate"><span class="pre">bridge</span></code>) et les redirections vers le serveur de metadata et
vers <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> sont posées dans le netns de chaque VPC, où l’agent coupe déjà
<code class="docutils literal notranslate"><span class="pre">bridge-nf-call-*</span></code>. Chargé, le module ferait passer tout le trafic bridgé des VM par netfilter
(<code class="docutils literal notranslate"><span class="pre">bridge-nf-call-iptables</span></code> vaut 1 par défaut).</p>
<p><strong>Réseau</strong> — création du bridge public, puis rattachement de l’uplink au bridge principal,
l’adresse et la route par défaut étant déplacées de l’interface physique vers le bridge.</p>
<p><strong>Segment public</strong> — <code class="docutils literal notranslate"><span class="pre">vxlan-public</span></code> est créé avec le VNI de <code class="docutils literal notranslate"><span class="pre">-N</span></code>, l’adresse IPv4 du bridge

View file

@ -737,7 +737,7 @@ 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 nftables de pont et iptables,
(<code class="docutils literal notranslate"><span class="pre">assert_clean</span></code> : netns, liens, adresses, routes, règles nftables de l’hôte et de chaque netns,
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
@ -785,147 +785,152 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>hv1</p></td>
<td><p>#41, #84, #79</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">21-dhcp-two</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">13-hote</span></code></p></td>
<td><p>connaissance de l’hôte — /register (hostname, CPU, RAM, OS, noyau) lu au démarrage, /ping (version, démarrages de l’hôte et de l’agent, uptime, load) mesuré périodiquement, lecture seule, redémarrage de l’agent distingué de celui de l’hôte</p></td>
<td><p>hv1</p></td>
<td><p>#39</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">21-dhcp-two</span></code></p></td>
<td><p>DHCP par le serveur intégré (backend two) — bail, server-id, renouvellement, option 121, un serveur par subnet, démarrages simultanés</p></td>
<td><p>hv1</p></td>
<td><p>#46, #57, #62</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">22-dhcp-dnsmasq</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">22-dhcp-dnsmasq</span></code></p></td>
<td><p>DHCP par dnsmasq (backend dnsmasq) — bail, server-id, renouvellement, option 121, une instance par subnet écoutant sur la gateway anycast</p></td>
<td><p>hv2</p></td>
<td><p>#46, #57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">23-metadonnees</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">23-metadonnees</span></code></p></td>
<td><p>serveur de métadonnées et cloud-init — sshkey, password (hash), user_data servi tel quel, documents absents (templates), VM sans compte</p></td>
<td><p>hv1</p></td>
<td><p>#43, #46</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">24-uefi</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">24-uefi</span></code></p></td>
<td><p>démarrage UEFI (OVMF) — firmware et variables par VM, VM démarrée en UEFI, témoin BIOS</p></td>
<td><p>hv1</p></td>
<td><p>UEFI (sans ticket)</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">25-multi-nic</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">25-multi-nic</span></code></p></td>
<td><p>VM à plusieurs interfaces — une NIC par subnet, adresses posées, route par défaut sur la primaire seule</p></td>
<td><p>hv1</p></td>
<td><p>#33, #62, #73</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td>
<td><p>VM à plusieurs disques — racine virtio (vda) et SCSI (xvdX), tailles et bus vus par la VM, liens /dev/xvdX et by-id par numéro de série, démarrage sur vda</p></td>
<td><p>hv1</p></td>
<td><p>#32, #74</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">27-reboot</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">27-reboot</span></code></p></td>
<td><p>redémarrage d’une VM depuis l’invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué</p></td>
<td><p>hv1</p></td>
<td><p>#46</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">28-mtu</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">28-mtu</span></code></p></td>
<td><p>MTU des VM (network.mtu_vm, 1500 par défaut) — annoncé par le DHCP (option 26, serveur intégré sur hv1, dnsmasq sur hv2) et par QEMU (host_mtu), porté par le tap, le bridge, le veth et le VXLAN du subnet ; subnet vxlan refusé sur un underlay qui n’est pas à 9000</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#56</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">29-dns-ntp</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">29-dns-ntp</span></code></p></td>
<td><p>DNS et NTP des VM par two-hostsvc — options DHCP 6 et 42 = interface_ip, redirection vers 169.254.169.253 dans le VPC (vxlan et bridge), seuls 53 et 123 servis, alertes du watchdog, VPC en error si two-hostsvc ne répond pas</p></td>
<td><p>hv1</p></td>
<td><p>#86</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">31-gateway</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">31-gateway</span></code></p></td>
<td><p>gateway d’un subnet vxlan — gateway anycast et adresse d’émission calculées, default_route et gateway explicite, routes DHCP, macvlan gw-, FDB locale, sysctls ARP, règles de confinement, suppression et recréation</p></td>
<td><p>hv1</p></td>
<td><p>#57, #43</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">32-vxlan-local</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">32-vxlan-local</span></code></p></td>
<td><p>routage entre deux subnets vxlan d’un même VPC sur un même hôte, sans et avec l3vni — ICMP, TCP, saut unique par la gateway</p></td>
<td><p>hv1</p></td>
<td><p>#57, #41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">33-bridge</span></code></p></td>
<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) ; 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, #76</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">34-isolation-locale</span></code></p></td>
<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>
<td><p>hv1</p></td>
<td><p>#50</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">35-filtrage-port</span></code></p></td>
<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 ; à 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, #76</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">41-evpn-l2</span></code></p></td>
<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>
<td><p>hv1 hv2</p></td>
<td><p>#50, #51</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">42-isolation-evpn</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">42-isolation-evpn</span></code></p></td>
<td><p>isolation entre VPC à travers EVPN — deux VPC sur la même plage, la VM d’un VPC ne joint pas celle de l’autre sur un hôte distant</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#50, #51</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">43-subnets-partages</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">43-subnets-partages</span></code></p></td>
<td><p>subnets vxlan partagés par deux hôtes, deux VM par hôte, dans un VPC avec et un VPC sans l3vni — toutes les paires, gateway anycast vue par chaque VM et absente d’EVPN, aucune MAC en double</p></td>
<td><p>hv2 hv3</p></td>
<td><p>#57, #41</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">44-fenetre-arp</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">44-fenetre-arp</span></code></p></td>
<td><p>fenêtre ARP de la gateway anycast entre deux hôtes — relais L2 depuis l’adresse d’émission d’un hôte, gateway de la VM inchangée, métadonnées, renouvellement DHCP et TCP local sans perte pendant la fenêtre</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">45-segment-public</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">45-segment-public</span></code></p></td>
<td><p>segment public de l’hôte — vxlan-public (VNI 1) posé par le bootstrap sur br-public, VNI annoncé en EVPN et vu par les bordures, gateway anycast des bordures installée vers une seule bordure, gateway et destination de test joignables sans doublon, L2 entre hyperviseurs, veth des VPC sur le bridge public, watchdog</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#87</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">46-passerelle-nat</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">46-passerelle-nat</span></code></p></td>
<td><p>passerelle NAT d’un VPC — macvlan ng-&lt;id&gt; sur le br-public du netns, MAC 02:04:00 + l3vni, SNAT vers l’IP de sortie (source vue à la sortie du netns), route par défaut en type 5 importée par un autre hôte, unreachable default jamais annoncée, rien n’entre sans connexion établie, refus 409, suppression propre, bascule vers un autre hôte par mobilité MAC</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#42</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">47-ip-flottante</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">47-ip-flottante</span></code></p></td>
<td><p>IP flottante d’une interface de VM — macvlan fip-&lt;hex&gt; sur le br-public du netns, MAC 02:05 + IP publique, NAT 1:1 sans état, routage par source (sortie par l’IP flottante, pas par la passerelle NAT du VPC), entrée neuve depuis le segment public, métadonnées servies, affichage sur la VM, refus 409, détachement, déplacement vers un autre hôte par mobilité MAC</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#88</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">48-subnet-public</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">48-subnet-public</span></code></p></td>
<td><p>subnet public_ip — VM qui porte son IP publique, subnet raccordé au bridge public de l’hôte (iface_type ignoré), même plage et même interface_ip pour plusieurs VPC sur un même hôte et sur deux hôtes, interface_ip invisible sur le segment, gateway et DNS propres à chaque VPC, sortie et entrée sans NAT, usurpation refusée, IP flottante refusée</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#89</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">51-l3vni</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">51-l3vni</span></code></p></td>
<td><p>routage inter-subnet entre hôtes par L3VNI (IRB symétrique) — VRF, RMAC, exports /24 et /32, RT-5 réfléchies, TTL, isolation par RT, unreachable default dans la VRF, démontage d’un VPC routé</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#41, #81</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">52-migration</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">52-migration</span></code></p></td>
<td><p>migration d’une adresse de VM entre hôtes d’un VPC routé — /32 retiré en premier, /24 en filet puis en ECMP, séquence orchestrée, 40 sources, suppression du subnet refusée tant qu’une VM l’utilise, MAC anycast hors EVPN</p></td>
<td><p>hv1 hv2 hv3</p></td>
<td><p>#41, #57</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">53-watchdog-l3</span></code></p></td>
<td><p>watchdog d’un VPC routé — /32 orphelin signalé comme trou noir, /32 manquant signalé, unreachable default absente signalée, aucune fausse alerte BGP ni L3VNI, trafic intact après les essais</p></td>
<td><p>hv1 hv3</p></td>
<td><p>#41, #81</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">61-redemarrage-agent</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">61-redemarrage-agent</span></code></p></td>
<td><p>redémarrage de l’agent avec des VM en marche — rien ne disparaît ni n’est recréé, trafic routé sans perte, DHCP et métadonnées servis, base BGP réappliquée à l’identique, ressources toujours gérées</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#41, #46</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">62-nettoyage-global</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">62-nettoyage-global</span></code></p></td>
<td><p>nettoyage global en fin de suite — aucun hôte ne garde de ressource : API vide, ni netns, tap, VRF, unité, instance DHCP ou de métadonnées, processus QEMU, règle de port, volume ; FRR réduit à la base BGP</p></td>
<td></td>
<td><p>#70</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">71-perte-rr</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">71-perte-rr</span></code></p></td>
<td><p>perte d’un route reflector — l’autre garde la session EVPN, le VTEP distant reste connu, le trafic L2 entre hôtes passe sans perte mesurable, retour du RR arrêté</p></td>
<td><p>hv1 hv2</p></td>
<td><p>#54</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code></p></td>
<td><p>perte d’un switch de la passerelle VRRP — bascule vers l’autre en moins de 5 s, sessions EVPN jamais coupées ; au retour, un seul maître (préemption désactivée : celui qui l’est est relevé), plus long silence mesuré</p></td>
<td></td>
<td><p>#54, #69, #80</p></td>

View file

@ -1734,6 +1734,129 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</dl>
</dd></dl>
<dl class="http get">
<dt class="sig sig-object http" id="get--register">
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/register</span></span><a class="headerlink" href="#get--register" title="Lien vers cette définition">#</a></dt>
<dd><p><strong>Facts of the host that do not change while it runs</strong></p>
<p>Read once when the agent starts and kept in memory. Will also be sent to the broker of the orchestrator at startup.</p>
<p><strong>Example request:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/register</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
</pre></div>
</div>
<dl class="field-list simple">
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
<dd class="field-odd"><ul class="simple">
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>Host facts</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"hostname"</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">"cpu"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nt">"vendor"</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">"model"</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">"sockets"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"cores"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"threads"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span>
<span class="w"> </span><span class="p">},</span>
<span class="w"> </span><span class="nt">"memory_bytes"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"os"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nt">"id"</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">"version_id"</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">"pretty_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="w"> </span><span class="p">},</span>
<span class="w"> </span><span class="nt">"kernel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/405">405 Method Not Allowed</a></span> – <p>Method other than GET</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">405</span> <span class="ne">Method Not Allowed</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/503">503 Service Unavailable</a></span> – <p>Host facts could not be read when the agent started (the error says why)</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">503</span> <span class="ne">Service Unavailable</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
</ul>
</dd>
</dl>
</dd></dl>
<dl class="http get">
<dt class="sig sig-object http" id="get--ping">
<span class="sig-name descname"><span class="pre">GET</span> </span><span class="sig-name descname"><span class="pre">/ping</span></span><a class="headerlink" href="#get--ping" title="Lien vers cette définition">#</a></dt>
<dd><p><strong>Current state of the host and of the agent</strong></p>
<p>Last reading, taken when the agent starts then every times.host_state_interval seconds and kept in memory; collected_at gives its age. boot_time and agent_start_time tell a host reboot from an agent restart; boot_time plus uptime_seconds give the clock of the host.</p>
<p><strong>Example request:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="nf">GET</span> <span class="nn">/ping</span> <span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span>
<span class="na">Host</span><span class="o">:</span> <span class="l">example.com</span>
</pre></div>
</div>
<dl class="field-list simple">
<dt class="field-odd">Codes de statut<span class="colon">:</span></dt>
<dd class="field-odd"><ul class="simple">
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/200">200 OK</a></span> – <p>Last host state</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">200</span> <span class="ne">OK</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"agent_version"</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">"collected_at"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"boot_time"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"agent_start_time"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"uptime_seconds"</span><span class="p">:</span><span class="w"> </span><span class="mf">1.0</span><span class="p">,</span>
<span class="w"> </span><span class="nt">"load"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
<span class="w"> </span><span class="mf">1.0</span>
<span class="w"> </span><span class="p">]</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/405">405 Method Not Allowed</a></span> – <p>Method other than GET</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">405</span> <span class="ne">Method Not Allowed</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/503">503 Service Unavailable</a></span> – <p>No reading has succeeded yet</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">503</span> <span class="ne">Service Unavailable</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
<span class="p">{</span>
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
<span class="p">}</span>
</pre></div>
</div>
</p></li>
</ul>
</dd>
</dl>
</dd></dl>
</section>

View file

@ -442,6 +442,7 @@ port. Ne pas l’exposer hors de la boucle locale.</p>
<span class="w"> </span><span class="nt">timeout_subnet_start</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
<span class="w"> </span><span class="nt">timeout_vms_start</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">300</span>
<span class="w"> </span><span class="nt">poll_interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
<span class="w"> </span><span class="nt">host_state_interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10</span>
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">worker.count</span></code> est le nombre de goroutines qui exécutent les commandes ; <code class="docutils literal notranslate"><span class="pre">buffer_size</span></code> le
@ -463,6 +464,9 @@ encore l’ACPI au premier appui (firmware, chargeur de démarrage) s’éteint
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">poll_interval</span></code></dt><dd><p>pas de toutes ces attentes.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">host_state_interval</span></code></dt><dd><p>intervalle entre deux mesures de l’état de l’hôte servi par <code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/ping</span></code> (voir
<a class="reference internal" href="observabilite.html"><span class="doc">Observabilité</span></a>).</p>
</dd>
</dl>
<p>Chaque valeur doit être strictement positive, et <code class="docutils literal notranslate"><span class="pre">next_vms_shutdown</span></code> inférieur à
<code class="docutils literal notranslate"><span class="pre">timeout_vms_stop</span></code> ; sinon l’agent refuse de démarrer. Les attentes s’enchaînent — une VM,

View file

@ -489,6 +489,7 @@ n’est jamais traversée : la trame est commutée en L2 et le serveur reste inj
<p>Depuis l’host, l’instance correspondante :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>systemctl<span class="w"> </span>status<span class="w"> </span><span class="s1">'metadata@&lt;vm&gt;'</span>
ls<span class="w"> </span>-l<span class="w"> </span>/run/two/metadata/&lt;vm&gt;/
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>ip<span class="w"> </span>two<span class="w"> </span>md-&lt;vm&gt;<span class="w"> </span><span class="c1"># une dnat par IP de la VM</span>
</pre></div>
</div>
</section>
@ -513,8 +514,7 @@ sudo<span class="w"> </span>cat<span class="w"> </span>/run/systemd/netif/leases
systemctl<span class="w"> </span>status<span class="w"> </span>two-hostsvc
cat<span class="w"> </span>/run/two/hostsvc/hostsvc.state<span class="w"> </span><span class="c1"># le VPC doit y figurer</span>
ip<span class="w"> </span>-n<span class="w"> </span>&lt;vpc&gt;<span class="w"> </span>-4<span class="w"> </span>addr<span class="w"> </span>show<span class="w"> </span>dev<span class="w"> </span>hostsvc<span class="w"> </span><span class="c1"># 169.254.169.253/32</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>iptables<span class="w"> </span>-t<span class="w"> </span>nat<span class="w"> </span>-S<span class="w"> </span>TWO-HOSTSVC<span class="w"> </span><span class="c1"># 2 RETURN puis 3 DNAT</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>iptables<span class="w"> </span>-t<span class="w"> </span>nat<span class="w"> </span>-L<span class="w"> </span>TWO-HOSTSVC<span class="w"> </span>-v<span class="w"> </span>-n<span class="w"> </span><span class="c1"># compteurs des redirections</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>ip<span class="w"> </span>two<span class="w"> </span>hostsvc<span class="w"> </span><span class="c1"># 2 return puis 3 dnat</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>ss<span class="w"> </span>-lntu<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span><span class="m">169</span>.254.169.253<span class="w"> </span><span class="c1"># 53/udp, 53/tcp, 123/udp</span>
journalctl<span class="w"> </span>-u<span class="w"> </span>two-hostsvc<span class="w"> </span>-n<span class="w"> </span><span class="m">50</span>
</pre></div>

View file

@ -347,6 +347,7 @@
<nav aria-label="Page">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metriques-prometheus">Métriques Prometheus</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#connaissance-de-l-hote">Connaissance de l’hôte</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#watchdog">Watchdog</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#journaux">Journaux</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#inspection-de-la-base">Inspection de la base</a></li>
@ -399,6 +400,29 @@
durable sur <code class="docutils literal notranslate"><span class="pre">error</span></code> est l’alerte la plus utile à poser ; une valeur durable sur <code class="docutils literal notranslate"><span class="pre">creating</span></code>
ou <code class="docutils literal notranslate"><span class="pre">deleting</span></code> signale une opération qui n’aboutit pas.</p>
</section>
<section id="connaissance-de-l-hote">
<h2>Connaissance de l’hôte<a class="headerlink" href="#connaissance-de-l-hote" title="Lien vers cette rubrique">#</a></h2>
<p>Deux routes de l’API de l’agent, en lecture seule (voir <a class="reference internal" href="api-agent/reference.html"><span class="doc">Référence</span></a>) :</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/register</span></code></dt><dd><p>ce qui ne change pas tant que l’hôte tourne : hostname, CPU (fabricant, modèle, sockets,
cœurs, threads), RAM totale, OS (<code class="docutils literal notranslate"><span class="pre">/etc/os-release</span></code>) et noyau. Lu une fois au démarrage de
l’agent ; si la lecture échoue, l’agent démarre quand même, journalise <code class="docutils literal notranslate"><span class="pre">host</span> <span class="pre">facts</span>
<span class="pre">unavailable</span></code> et la route répond 503 avec l’erreur.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">GET</span> <span class="pre">/ping</span></code></dt><dd><p>l’état courant : version de l’agent, démarrage de l’hôte (<code class="docutils literal notranslate"><span class="pre">boot_time</span></code>) et de l’agent
(<code class="docutils literal notranslate"><span class="pre">agent_start_time</span></code>), uptime de l’hôte et load sur 1, 5 et 15 minutes. Mesuré au démarrage
puis toutes les <code class="docutils literal notranslate"><span class="pre">times.host_state_interval</span></code> secondes (10 par défaut), gardé en mémoire ;
<code class="docutils literal notranslate"><span class="pre">collected_at</span></code> donne l’heure de la mesure. 503 tant qu’aucune mesure n’a réussi ; une mesure
en échec est journalisée (<code class="docutils literal notranslate"><span class="pre">host</span> <span class="pre">state</span> <span class="pre">collection</span> <span class="pre">failed</span></code>) et la précédente reste servie.</p>
</dd>
</dl>
<p>Les dates sont des timestamps Unix en secondes. Un <code class="docutils literal notranslate"><span class="pre">boot_time</span></code> qui change signale un
redémarrage de l’hôte, un <code class="docutils literal notranslate"><span class="pre">agent_start_time</span></code> seul un redémarrage de l’agent ;
<code class="docutils literal notranslate"><span class="pre">boot_time</span></code> + <code class="docutils literal notranslate"><span class="pre">uptime_seconds</span></code> donne l’horloge de l’hôte au moment de la mesure.</p>
<p>La version de l’agent est injectée au build : le tag pour une release, le commit court
(suffixé <code class="docutils literal notranslate"><span class="pre">-dirty</span></code> si l’arbre avait des modifications) pour les binaires de test du lab,
<code class="docutils literal notranslate"><span class="pre">undefined</span></code> sinon. Elle figure aussi dans la ligne <code class="docutils literal notranslate"><span class="pre">starting</span> <span class="pre">agent</span></code> du journal.</p>
</section>
<section id="watchdog">
<h2>Watchdog<a class="headerlink" href="#watchdog" title="Lien vers cette rubrique">#</a></h2>
<p>Une goroutine périodique vérifie que les ressources marquées <code class="docutils literal notranslate"><span class="pre">running</span></code> en base existent
@ -420,8 +444,8 @@ numéro du VNI.</p>
<li><p><code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code> injoignable sur sa socket de contrôle : une notification, aucun VPC de
l’hyperviseur n’a plus de DNS ni de NTP ;</p></li>
<li><p>pour chaque VPC <code class="docutils literal notranslate"><span class="pre">running</span></code> : VPC absent de la liste servie par <code class="docutils literal notranslate"><span class="pre">two-hostsvc</span></code>,
<code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code> absente de la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code>, ou chaîne <code class="docutils literal notranslate"><span class="pre">TWO-HOSTSVC</span></code> absente ou
incomplète dans son netns. Un VPC créé par une version antérieure à la 0.3.0 n’a rien de tout
<code class="docutils literal notranslate"><span class="pre">169.254.169.253</span></code> absente de la <code class="docutils literal notranslate"><span class="pre">dummy</span></code> <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code>, ou chaîne <code class="docutils literal notranslate"><span class="pre">hostsvc</span></code> de la table
<code class="docutils literal notranslate"><span class="pre">ip</span> <span class="pre">two</span></code> absente ou incomplète dans son netns. Un VPC créé par une version antérieure à la 0.3.0 n’a rien de tout
cela : il est signalé à chaque tick jusqu’à sa recréation.</p></li>
</ul>
<p>Avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans la configuration, il contrôle aussi le plan de contrôle :</p>
@ -533,6 +557,7 @@ deux processus ne doivent pas ouvrir la même instance.</p>
<nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#metriques-prometheus">Métriques Prometheus</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#connaissance-de-l-hote">Connaissance de l’hôte</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#watchdog">Watchdog</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#journaux">Journaux</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#inspection-de-la-base">Inspection de la base</a></li>

View file

@ -796,6 +796,8 @@ window.runMermaid = runMermaid;</script>
<div class="modindex-jumpbox">
<a href="#cap-/floating-ips"><strong>/floating-ips</strong></a> |
<a href="#cap-/nat-gateways"><strong>/nat-gateways</strong></a> |
<a href="#cap-/ping"><strong>/ping</strong></a> |
<a href="#cap-/register"><strong>/register</strong></a> |
<a href="#cap-/subnets"><strong>/subnets</strong></a> |
<a href="#cap-/vms"><strong>/vms</strong></a> |
<a href="#cap-/vpcs"><strong>/vpcs</strong></a>
@ -849,6 +851,22 @@ window.runMermaid = runMermaid;</script>
<a href="exploitation/api-agent/reference.html#delete--nat-gateways-name"><code class="xref">DELETE /nat-gateways/{name}</code></a></td><td>
<em>Delete a NAT gateway</em></td></tr>
<tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
<tr class="cap" id="cap-/ping"><td></td><td>
<strong>/ping</strong></td><td></td></tr>
<tr>
<td></td>
<td>
<a href="exploitation/api-agent/reference.html#get--ping"><code class="xref">GET /ping</code></a></td><td>
<em>Current state of the host and of the agent</em></td></tr>
<tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
<tr class="cap" id="cap-/register"><td></td><td>
<strong>/register</strong></td><td></td></tr>
<tr>
<td></td>
<td>
<a href="exploitation/api-agent/reference.html#get--register"><code class="xref">GET /register</code></a></td><td>
<em>Facts of the host that do not change while it runs</em></td></tr>
<tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
<tr class="cap" id="cap-/subnets"><td></td><td>
<strong>/subnets</strong></td><td></td></tr>
<tr>

Binary file not shown.

File diff suppressed because one or more lines are too long