This commit is contained in:
forgejo-actions 2026-10-30 20:53:21 +00:00
commit 314bcd7d4e
40 changed files with 2298 additions and 34 deletions

View file

@ -234,6 +234,8 @@
<li class="toctree-l2"><a class="reference internal" href="../concepts/cycle-de-vie.html">Cycle de vie des ressources</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/metadata-cloud-init.html">Metadata et cloud-init</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/dns-ntp.html">DNS et NTP des VM</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/passerelle-nat.html">Passerelle NAT</a></li>
<li class="toctree-l2"><a class="reference internal" href="../concepts/ip-flottante.html">IP flottante</a></li>
</ul>
</details></li>
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Architecture</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
@ -376,6 +378,7 @@ subnet/&lt;name&gt;/default_route → "true" | "false"
subnet/&lt;name&gt;/gateway → &lt;ip&gt; (optionnel)
vm/&lt;name&gt;/state → creating | running | error | deleting | deleted
vm/&lt;name&gt;/nic/&lt;i&gt;/name → &lt;nom&gt; (choisi par l'appelant, unique dans la VM)
vm/&lt;name&gt;/nic/&lt;i&gt;/subnet → &lt;subnet-name&gt; (une interface par index, ordre du tableau interfaces)
vm/&lt;name&gt;/nic/&lt;i&gt;/ip → &lt;ip&gt;
vm/&lt;name&gt;/nic/&lt;i&gt;/mac → &lt;mac&gt; (fournie par l'appelant, conservée telle quelle)
@ -390,6 +393,17 @@ vm/&lt;name&gt;/uefi → "true" (absent si SeaBIOS)
vm/&lt;name&gt;/password → &lt;hash&gt; (optionnel — un hash, pas un mot de passe)
vm/&lt;name&gt;/sshkey → &lt;pubkey&gt; (optionnel)
vm/&lt;name&gt;/metadata/&lt;document&gt; → &lt;contenu brut&gt; (optionnel : user-data, vendor-data, …)
nat-gateway/&lt;name&gt;/state → creating | running | error | deleting | deleted
nat-gateway/&lt;name&gt;/vpc → &lt;vpc-name&gt; (une passerelle par VPC)
nat-gateway/&lt;name&gt;/ip → &lt;ip&gt;/&lt;préfixe&gt; (IP de sortie, telle que fournie)
nat-gateway/&lt;name&gt;/gateway → &lt;ip&gt; (gateway des bordures)
floating-ip/&lt;name&gt;/state → creating | running | error | deleting | deleted
floating-ip/&lt;name&gt;/vm → &lt;vm-name&gt;
floating-ip/&lt;name&gt;/interface → &lt;nom&gt; (nom de l'interface de la VM ; l'IP privée y est lue)
floating-ip/&lt;name&gt;/ip → &lt;ip&gt;/&lt;préfixe&gt; (IP publique, telle que fournie)
floating-ip/&lt;name&gt;/gateway → &lt;ip&gt; (gateway des bordures)
</pre></div>
</div>
<section id="regles">
@ -407,6 +421,8 @@ recopie la MAC de chaque interface existante dans <code class="docutils literal
clés. Les VM <code class="docutils literal notranslate"><span class="pre">deleted</span></code> sont ignorées. Une interface dont la MAC est introuvable fait échouer le
démarrage en la nommant, et la table reste en place tant que toutes les interfaces ne sont pas
migrées.</p>
<p><strong>Interfaces sans nom.</strong> Avant la 0.3.0, une interface n’avait pas de nom. Au démarrage, l’agent
nomme <code class="docutils literal notranslate"><span class="pre">nic-&lt;i&gt;</span></code> chaque interface qui n’en a pas, d’après son rang ; un nom existant est gardé.</p>
<p><strong>Anciens noms de disques.</strong> Jusqu’en 0.1.0, les disques additionnels s’appelaient <code class="docutils literal notranslate"><span class="pre">sdX</span></code>. Au
démarrage, l’agent renomme chaque clé <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/sdX</span></code> en <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/xvdX</span></code> (même
lettre, même cible SCSI). Si <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> existe déjà avec un autre chemin, le démarrage échoue en