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

@ -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">