This commit is contained in:
forgejo-actions 2026-10-25 18:33:40 +00:00
commit 88d5b278a3
8 changed files with 58 additions and 23 deletions

View file

@ -411,7 +411,8 @@ casserait le démarrage (<code class="docutils literal notranslate"><span class=
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>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">dispatcher.timeout_seconds</span></code>.</p></li>
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>
</ul>
</section>
<section id="arret-de-l-agent">

View file

@ -841,7 +841,10 @@ window.runMermaid = runMermaid;</script>
<h2>Suppression<a class="headerlink" href="#suppression" title="Lien vers cette rubrique">#</a></h2>
<p>Elle n’est autorisée que depuis <code class="docutils literal notranslate"><span class="pre">running</span></code> ou <code class="docutils literal notranslate"><span class="pre">error</span></code> — sinon <strong>409</strong>. Depuis <code class="docutils literal notranslate"><span class="pre">error</span></code>, elle
est <strong>best-effort</strong> : les ressources système peuvent n’avoir été créées que partiellement.</p>
<p>Un VPC ne peut être supprimé qu’une fois tous ses subnets supprimés.</p>
<p>Un VPC ne peut être supprimé qu’une fois tous ses subnets supprimés ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>, un subnet
qu’une fois toutes ses VM supprimées ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>. Les enfants encore en <code class="docutils literal notranslate"><span class="pre">deleting</span></code> sont
attendus (<code class="docutils literal notranslate"><span class="pre">times.timeout_vpc_stop</span></code>, <code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_stop</span></code>) ; si l’un d’eux passe en
<code class="docutils literal notranslate"><span class="pre">error</span></code>, la suppression du parent échoue, et le parent passe en <code class="docutils literal notranslate"><span class="pre">error</span></code> à son tour.</p>
</section>
<section id="pas-de-rollback">
<h2>Pas de rollback<a class="headerlink" href="#pas-de-rollback" title="Lien vers cette rubrique">#</a></h2>

View file

@ -835,7 +835,7 @@ route interne, quel que soit le mode du subnet.</p>
</div>
<p>Un subnet peut être demandé dès maintenant : il est accepté tant que le VPC est en <code class="docutils literal notranslate"><span class="pre">creating</span></code>
ou <code class="docutils literal notranslate"><span class="pre">running</span></code>, et sa création attend que le VPC soit <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de
<code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code>. Il n’est refusé en <strong>422</strong> que si le VPC est absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code>
<code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_start</span></code>. Il n’est refusé en <strong>422</strong> que si le VPC est absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code>
ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>. Le modèle d’attente est décrit dans <a class="reference internal" href="../exploitation/api-agent/asynchronisme.html"><span class="doc">Modèle asynchrone et codes de retour</span></a>.</p>
</section>
<section id="le-subnet">

View file

@ -760,9 +760,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#41, #57, #33, #62, #74, #81</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">12-etats</span></code></p></td>
<td><p>machine d’états — 409 pendant creating, suppression depuis error, sockets QEMU d’une VM en error retirés, dépendances VM → subnet → VPC, recréation sous le même nom</p></td>
<td><p>machine d’états — 409 pendant creating, suppression depuis error, sockets QEMU d’une VM en error retirés, dépendances VM → subnet → VPC, suppression d’un subnet en attente de ses VM, arrêt d’une VM juste démarrée par renvoi de system_powerdown, recréation sous le même nom</p></td>
<td><p>hv1</p></td>
<td><p>#41, #84</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>
<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>
@ -905,7 +905,7 @@ retour, après coupure puis rétablissement de l’interface underlay du maître
établie</strong>. <code class="docutils literal notranslate"><span class="pre">72-perte-switch</span></code> n’exige donc plus que le plus prioritaire redevienne maître : il
vérifie qu’il n’y a qu’un maître, note lequel, et mesure le plus long silence après le retour ;</p></li>
<li><p>une suppression de VM peut durer 300 s quand l’invité ignore l’arrêt ACPI (#79) : <code class="docutils literal notranslate"><span class="pre">wait_state</span></code>
attend jusqu’à 360 s.</p></li>
attend jusqu’à 480 s, au-delà du <code class="docutils literal notranslate"><span class="pre">times.timeout_vpc_stop</span></code> par défaut (420 s).</p></li>
</ul>
<p>Hypothèses vérifiées en lab, à garder en tête en écrivant un test :</p>
<ul class="simple">

View file

@ -831,14 +831,18 @@ un état stable.</p>
</div>
<p>Trois règles pour un appelant robuste :</p>
<ul class="simple">
<li><p><strong>Toujours borner l’attente.</strong> Côté agent, <code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> (300 s par défaut)
borne les opérations qui attendent une transition ; l’appelant doit avoir sa propre borne.</p></li>
<li><p><strong>Toujours borner l’attente.</strong> Côté agent, la section <code class="docutils literal notranslate"><span class="pre">times</span></code> de la configuration borne les
opérations qui attendent une transition ; l’appelant doit avoir sa propre borne.</p></li>
<li><p><strong>Traiter ``error`` comme terminal, pas comme un échec transitoire.</strong> Un <code class="docutils literal notranslate"><span class="pre">Execute</span></code> en échec
ne se rejoue pas tout seul.</p></li>
<li><p><strong>Savoir ce qui s’enchaîne.</strong> Créer un subnet dont le VPC est encore en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, ou
démarrer une VM sur un subnet en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, est accepté : l”<code class="docutils literal notranslate"><span class="pre">Execute</span></code> attend que le parent
passe <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de <code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> ; au-delà, la ressource passe
en <code class="docutils literal notranslate"><span class="pre">error</span></code>. Le refus en 422 ne vaut que pour un parent absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>.</p></li>
passe <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de <code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_start</span></code> ou <code class="docutils literal notranslate"><span class="pre">times.timeout_vms_start</span></code> ;
au-delà, la ressource passe en <code class="docutils literal notranslate"><span class="pre">error</span></code>. Le refus en 422 ne vaut que pour un parent absent, en
<code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>. À la suppression, c’est l’inverse : une VM puis son subnet, ou un
subnet puis son VPC, peuvent être supprimés d’un coup ; le parent attend que ses enfants en
<code class="docutils literal notranslate"><span class="pre">deleting</span></code> soient supprimés (<code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_stop</span></code>, <code class="docutils literal notranslate"><span class="pre">times.timeout_vpc_stop</span></code>), et passe
en <code class="docutils literal notranslate"><span class="pre">error</span></code> si l’un d’eux échoue.</p></li>
</ul>
</section>
<section id="codes-de-retour">
@ -875,8 +879,8 @@ en <code class="docutils literal notranslate"><span class="pre">error</span></co
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
<td><p>conflit d’existence ou d’état : ressource déjà créée, ou suppression depuis un état qui
ne l’autorise pas ; pour un VPC, subnets encore présents, <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> déjà utilisée par un
autre VPC, ou <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandée sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> ; pour un subnet, VM non supprimées
qui l’utilisent encore</p></td>
autre VPC, ou <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandée sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> ; pour un subnet, VM qui l’utilisent
encore, ni supprimées ni en <code class="docutils literal notranslate"><span class="pre">deleting</span></code></p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
<td><p>dépendance absente ou inutilisable : VPC parent d’un subnet, subnet d’une VM, absent, en

View file

@ -561,7 +561,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, and all its subnets must be deleted first</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, and all its subnets must be deleted or deleting; subnets still deleting are awaited by the asynchronous deletion</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">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
@ -1179,7 +1179,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and no VM that is not deleted may still have an interface on it</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and every VM with an interface on it must be deleted or deleting; VMs still deleting are awaited by the asynchronous deletion</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">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>

View file

@ -430,20 +430,47 @@ port. Ne pas l’exposer hors de la boucle locale.</p>
<span class="w"> </span><span class="nt">count</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">4</span>
<span class="w"> </span><span class="nt">buffer_size</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">100</span>
<span class="nt">dispatcher</span><span class="p">:</span>
<span class="w"> </span><span class="nt">timeout_seconds</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_seconds</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">2</span>
<span class="nt">times</span><span class="p">:</span>
<span class="w"> </span><span class="nt">timeout_vms_stop</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">next_vms_shutdown</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">30</span>
<span class="w"> </span><span class="nt">timeout_subnet_stop</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">360</span>
<span class="w"> </span><span class="nt">timeout_vpc_stop</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">420</span>
<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>
</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
nombre de commandes en attente au-delà duquel <code class="docutils literal notranslate"><span class="pre">Dispatch</span></code> bloque.</p>
<p><code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> borne les opérations qui attendent une transition d’état, dont
l’extinction d’une VM.</p>
<p>La section <code class="docutils literal notranslate"><span class="pre">times</span></code> règle, en secondes, les attentes des commandes asynchrones :</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">timeout_vms_stop</span></code></dt><dd><p>arrêt propre d’une VM : au-delà, QEMU reçoit un <code class="docutils literal notranslate"><span class="pre">quit</span></code> QMP.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">next_vms_shutdown</span></code></dt><dd><p>intervalle entre deux <code class="docutils literal notranslate"><span class="pre">system_powerdown</span></code> pendant cet arrêt. Un invité qui n’écoutait pas
encore l’ACPI au premier appui (firmware, chargeur de démarrage) s’éteint au suivant.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">timeout_subnet_stop</span></code></dt><dd><p>suppression d’un subnet : attente de ses VM encore en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">timeout_vpc_stop</span></code></dt><dd><p>suppression d’un VPC : attente de ses subnets encore en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">timeout_subnet_start</span></code></dt><dd><p>création d’un subnet : attente de son VPC <code class="docutils literal notranslate"><span class="pre">running</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">timeout_vms_start</span></code></dt><dd><p>création d’une VM : attente des subnets de ses interfaces <code class="docutils literal notranslate"><span class="pre">running</span></code>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">poll_interval</span></code></dt><dd><p>pas de toutes ces attentes.</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,
puis son subnet, puis le VPC : garder <code class="docutils literal notranslate"><span class="pre">timeout_vms_stop</span></code> &lt; <code class="docutils literal notranslate"><span class="pre">timeout_subnet_stop</span></code> &lt;
<code class="docutils literal notranslate"><span class="pre">timeout_vpc_stop</span></code> pour qu’une suppression en cascade envoyée d’un coup aboutisse.</p>
<p>L’ancienne section <code class="docutils literal notranslate"><span class="pre">dispatcher</span></code> (<code class="docutils literal notranslate"><span class="pre">timeout_seconds</span></code>, <code class="docutils literal notranslate"><span class="pre">poll_seconds</span></code>) n’est plus lue : restée
dans un fichier, elle est ignorée.</p>
<div class="admonition warning">
<p class="admonition-title">Avertissement</p>
<p>À l’expiration de ce délai, une VM qui ne s’est pas éteinte reçoit un <code class="docutils literal notranslate"><span class="pre">quit</span></code> QMP — un arrêt
<strong>brutal</strong>. Pour des charges dont l’extinction est lente (bases de données, construction
d’images), une valeur confortable évite un système de fichiers invité incohérent.</p>
<p>À l’expiration de <code class="docutils literal notranslate"><span class="pre">timeout_vms_stop</span></code>, une VM qui ne s’est pas éteinte reçoit un <code class="docutils literal notranslate"><span class="pre">quit</span></code>
QMP — un arrêt <strong>brutal</strong>. Pour des charges dont l’extinction est lente (bases de données,
construction d’images), une valeur confortable évite un système de fichiers invité incohérent.</p>
</div>
</section>
<section id="correspondance-des-interfaces">

File diff suppressed because one or more lines are too long