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

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