This commit is contained in:
forgejo-actions 2026-10-11 23:12:04 +00:00
commit d081a75883
7 changed files with 209 additions and 42 deletions

View file

@ -374,9 +374,10 @@ subnet/<name>/gateway → <ip> (optionnel)
subnet/<name>/dhcp/<ip> → <mac>
vm/<name>/state → creating | running | error | deleting | deleted
vm/<name>/subnet → <subnet-name>
vm/<name>/tap_id → <int>
vm/<name>/ip → <ip>
vm/<name>/nic/<i>/subnet → <subnet-name> (une interface par index, ordre du tableau interfaces)
vm/<name>/nic/<i>/ip → <ip>
vm/<name>/nic/<i>/primary → "true" (exactement une interface ; absent sur les autres)
vm/<name>/nic/<i>/tap_id → <int> (alloué au premier démarrage, puis conservé)
vm/<name>/metadata_port → <port>
vm/<name>/disk/<dev> → <path> (une clé par disque : sda, vda, …)
vm/<name>/memory → <int> (Mo)
@ -389,9 +390,13 @@ vm/<name>/metadata/<document> → <contenu brut> (optionnel :
</div>
<section id="regles">
<h2>Règles<a class="headerlink" href="#regles" title="Lien vers cette rubrique">#</a></h2>
<p><strong>Pas de duplication.</strong> Une ressource ne stocke que ce qui lui est propre. Une VM garde le lien
<code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/subnet</span></code> ; le VPC, le bridge et l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> sont lus depuis le subnet, leur
source canonique.</p>
<p><strong>Pas de duplication.</strong> Une ressource ne stocke que ce qui lui est propre. Une interface de VM
garde le lien <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/nic/&lt;i&gt;/subnet</span></code> ; le VPC, le mode, le bridge et l”<code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> sont
lus depuis le subnet, leur source canonique. De même, la L3VNI d’un VPC n’est stockée que sous
<code class="docutils literal notranslate"><span class="pre">vpc/&lt;name&gt;/l3vni</span></code> : RT, RD, MAC de routeur et table de routage en sont calculés.</p>
<p><strong>Ancien schéma des VM.</strong> Avant le multi-interfaces, une VM portait directement <code class="docutils literal notranslate"><span class="pre">subnet</span></code>, <code class="docutils literal notranslate"><span class="pre">ip</span></code>
et <code class="docutils literal notranslate"><span class="pre">tap_id</span></code>. L’agent les migre au démarrage vers <code class="docutils literal notranslate"><span class="pre">nic/0/…</span></code>, marquée <code class="docutils literal notranslate"><span class="pre">primary</span></code>, avant
d’ouvrir son API ; une VM qui a déjà des clés <code class="docutils literal notranslate"><span class="pre">nic/</span></code> est laissée telle quelle.</p>
<p><strong>Les états passent par ``state``.</strong> Toujours <code class="docutils literal notranslate"><span class="pre">state.Set</span></code> / <code class="docutils literal notranslate"><span class="pre">state.Get</span></code> : <code class="docutils literal notranslate"><span class="pre">Set</span></code> refuse une
valeur hors énumération, <code class="docutils literal notranslate"><span class="pre">Get</span></code> refuse de retourner une valeur non reconnue. <code class="docutils literal notranslate"><span class="pre">error</span></code> n’est
écrit que par <code class="docutils literal notranslate"><span class="pre">Dispatcher.Dispatch</span></code>, via <code class="docutils literal notranslate"><span class="pre">cmd.Key()</span></code>.</p>