docs: build de da6295baf1
This commit is contained in:
parent
2fc17b7ffe
commit
88d5b278a3
8 changed files with 58 additions and 23 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -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> < <code class="docutils literal notranslate"><span class="pre">timeout_subnet_stop</span></code> <
|
||||
<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">
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue