This commit is contained in:
forgejo-actions 2026-10-23 21:40:15 +00:00
commit bb924859e0
8 changed files with 54 additions and 12 deletions

View file

@ -399,7 +399,8 @@ tous les hôtes, une réponse peut partir vers un autre hôte.</p></li>
<section id="qemu-et-vm">
<h2>QEMU et VM<a class="headerlink" href="#qemu-et-vm" title="Lien vers cette rubrique">#</a></h2>
<ul class="simple">
<li><p><strong>Un seul disque ``vdX`` par VM</strong> ; les disques additionnels passent par le SCSI (<code class="docutils literal notranslate"><span class="pre">sdX</span></code>). La
<li><p><strong>Un seul disque virtio, ``vda``, le disque racine</strong> ; les disques additionnels passent par le SCSI
(<code class="docutils literal notranslate"><span class="pre">xvdX</span></code>, cible X). La
carte PCI en dépend : NIC en <code class="docutils literal notranslate"><span class="pre">0x03</span></code>, contrôleur SCSI en <code class="docutils literal notranslate"><span class="pre">0x1e</span></code>, virtio-blk en <code class="docutils literal notranslate"><span class="pre">0x1f</span></code>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">bus=pci.0</span></code> est explicite sur les trois <code class="docutils literal notranslate"><span class="pre">-device</span></code> : un passage de la machine en <strong>q35</strong>
casserait le démarrage (<code class="docutils literal notranslate"><span class="pre">Bus</span> <span class="pre">'pci.0'</span> <span class="pre">not</span> <span class="pre">found</span></code>).</p></li>

View file

@ -380,7 +380,7 @@ vm/&lt;name&gt;/nic/&lt;i&gt;/mac → &lt;mac&gt; (fournie par
vm/&lt;name&gt;/nic/&lt;i&gt;/primary → "true" (exactement une interface ; absent sur les autres)
vm/&lt;name&gt;/nic/&lt;i&gt;/tap_id → &lt;int&gt; (alloué au premier démarrage, puis conservé)
vm/&lt;name&gt;/metadata_port → &lt;port&gt;
vm/&lt;name&gt;/disk/&lt;dev&gt; → &lt;path&gt; (une clé par disque : sda, vda, …)
vm/&lt;name&gt;/disk/&lt;dev&gt; → &lt;path&gt; (une clé par disque : vda, xvda, xvdb, …)
vm/&lt;name&gt;/memory → &lt;int&gt; (Mo)
vm/&lt;name&gt;/cpus → &lt;int&gt;
vm/&lt;name&gt;/uefi → "true" (absent si SeaBIOS)
@ -404,6 +404,11 @@ 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>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
nommant la clé. Le numéro de série du disque, et donc son lien <code class="docutils literal notranslate"><span class="pre">by-id</span></code>, prend le nouveau nom au
prochain lancement de la VM.</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>

View file

@ -872,9 +872,12 @@ en <code class="docutils literal notranslate"><span class="pre">/32</span></code
suppression, ces <code class="docutils literal notranslate"><span class="pre">/32</span></code> sont retirés <strong>avant</strong> l’arrêt de QEMU. Comme un subnet ne peut être
supprimé tant qu’une VM l’utilise, le <code class="docutils literal notranslate"><span class="pre">/32</span></code> d’une VM est toujours retiré avant le <code class="docutils literal notranslate"><span class="pre">/24</span></code> de son
subnet — l’ordre qui évite le trou noir de <a class="reference external" href="https://git.g3e.fr/syonad/two/issues/41">#41</a>.</p>
<p><strong>Stockage.</strong> Un seul disque <code class="docutils literal notranslate"><span class="pre">vdX</span></code> (virtio-blk) par VM ; les disques supplémentaires passent
par le contrôleur SCSI (<code class="docutils literal notranslate"><span class="pre">sdX</span></code>). Cette contrainte vient de la carte PCI figée — voir
<a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>.</p>
<p><strong>Stockage.</strong> Un seul disque virtio par VM, <code class="docutils literal notranslate"><span class="pre">vda</span></code>, le disque racine ; les disques
supplémentaires passent par le contrôleur SCSI (<code class="docutils literal notranslate"><span class="pre">xvdX</span></code>, cible X). Cette contrainte vient de la
carte PCI figée — voir <a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>. <code class="docutils literal notranslate"><span class="pre">dev</span></code> fixe l’emplacement du disque
(cible SCSI, slot PCI) et son numéro de série, pas le nom que lui donne le noyau du guest
(<code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code>, dans l’ordre de détection) : le disque se retrouve par <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code> dans une
image conforme, et toujours par <code class="docutils literal notranslate"><span class="pre">/dev/disk/by-id/…&lt;dev&gt;</span></code>.</p>
</section>
<section id="ce-qui-est-stocke-et-ou">
<h2>Ce qui est stocké, et où<a class="headerlink" href="#ce-qui-est-stocke-et-ou" title="Lien vers cette rubrique">#</a></h2>

View file

@ -874,7 +874,7 @@ obligatoire.</p>
<span class="s1"> "storage": [{"path": "/var/lib/two/volumes/i-web.qcow2", "dev": "vda"}]}'</span>
</pre></div>
</div>
<p>Quatre points qui coûtent du temps quand on les découvre en production :</p>
<p>Six points qui coûtent du temps quand on les découvre en production :</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">user_data</span></code> est <strong>encodé en base64</strong></dt><dd><p>Un base64 invalide est rejeté en 400 plutôt que servi vide. L’agent n’interprète jamais ce
contenu.</p>
@ -889,9 +889,15 @@ même segment L2 doivent avoir des MAC distinctes.</p>
slot PCI (<code class="docutils literal notranslate"><span class="pre">0x03</span> <span class="pre">+</span> <span class="pre">index</span></code>), donc le nom de l’interface dans le guest. Tous les subnets d’une
VM doivent appartenir au même VPC.</p>
</dd>
<dt>Un seul disque <code class="docutils literal notranslate"><span class="pre">vdX</span></code></dt><dd><p>Les disques supplémentaires passent par <code class="docutils literal notranslate"><span class="pre">sdX</span></code>. La carte PCI en dépend — voir
<dt><code class="docutils literal notranslate"><span class="pre">vda</span></code> pour la racine, <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> pour les autres disques</dt><dd><p><code class="docutils literal notranslate"><span class="pre">vda</span></code> est le disque racine, virtio, démarré en premier. Les disques supplémentaires sont des
<code class="docutils literal notranslate"><span class="pre">xvdX</span></code> (<code class="docutils literal notranslate"><span class="pre">xvda</span></code> = cible SCSI 0) ; <code class="docutils literal notranslate"><span class="pre">sdX</span></code> est refusé (400). La carte PCI en dépend — voir
<a class="reference internal" href="../architecture/contraintes.html"><span class="doc">Invariants et pièges</span></a>.</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code> dans le guest, jamais <code class="docutils literal notranslate"><span class="pre">/dev/sdX</span></code></dt><dd><p>Le noyau du guest nomme les disques SCSI <code class="docutils literal notranslate"><span class="pre">sdX</span></code> dans l’ordre de détection, qui change d’un
démarrage à l’autre. L’agent donne à chaque disque le numéro de série <code class="docutils literal notranslate"><span class="pre">&lt;dev&gt;</span></code> ; une image
conforme (<a class="reference internal" href="../deploiement/image-qcow2.html"><span class="doc">Construction de l’image qcow2</span></a>) en fait le lien <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code>. Sans cette règle,
le nom stable reste <code class="docutils literal notranslate"><span class="pre">/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX</span></code>.</p>
</dd>
</dl>
</section>
<section id="verifier">

View file

@ -1064,6 +1064,18 @@ interface (<code class="docutils literal notranslate"><span class="pre">10-netpl
l’image Rocky de cette page, n’est pas encore vérifié. Sans lui, une VM à plusieurs
interfaces n’a de bail que sur la première.</p>
</div>
<p><strong>Noms stables des disques additionnels</strong></p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span><span class="s">&lt;&lt; 'ENDFILE' &gt; /mnt/etc/udev/rules.d/90-two-xvd.rules</span>
<span class="s">SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL_SHORT}=="xvd[a-z]", SYMLINK+="$env{ID_SERIAL_SHORT}"</span>
<span class="s">SUBSYSTEM=="block", ENV{DEVTYPE}=="partition", ENV{ID_SERIAL_SHORT}=="xvd[a-z]", SYMLINK+="$env{ID_SERIAL_SHORT}%n"</span>
<span class="s">ENDFILE</span>
</pre></div>
</div>
<p>L’agent donne à chaque disque additionnel le numéro de série <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> déclaré dans l’API ; ces
règles en font <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code> (et <code class="docutils literal notranslate"><span class="pre">/dev/xvdXN</span></code> pour ses partitions). Le noyau, lui, nomme les
disques SCSI <code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code> dans l’ordre de détection, qui change d’un démarrage à l’autre : une
<code class="docutils literal notranslate"><span class="pre">fstab</span></code> ou un script de la VM doit viser <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code>, jamais <code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code>. Le disque racine
reste <code class="docutils literal notranslate"><span class="pre">/dev/vda</span></code>.</p>
<p><strong>Services et durcissement</strong></p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>chroot<span class="w"> </span>/mnt/<span class="w"> </span>systemctl<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>fstrim.timer

View file

@ -787,9 +787,9 @@ fait en fermant le ticket. Chaque ticket concerné liste ses marqueurs en commen
<td><p>#33, #62, #73</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">26-multi-disque</span></code></p></td>
<td><p>VM à plusieurs disques — virtio (vdX) et SCSI (sdX), tailles et bus vus par la VM, démarrage sur vda</p></td>
<td><p>VM à plusieurs disques — racine virtio (vda) et SCSI (xvdX), tailles et bus vus par la VM, liens <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code> et <code class="docutils literal notranslate"><span class="pre">by-id</span></code> par numéro de série, démarrage sur vda</p></td>
<td><p>hv1</p></td>
<td><p>#32</p></td>
<td><p>#32, #74</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">27-reboot</span></code></p></td>
<td><p>redémarrage d’une VM depuis l’invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué</p></td>
@ -899,7 +899,7 @@ attend jusqu’à 360 s.</p></li>
<ul class="simple">
<li><p>systemd-networkd <strong>ne réécrit pas</strong> un bail renouvelé à l’identique : un renouvellement se
vérifie par le DHCPACK dans le journal du serveur (<code class="docutils literal notranslate"><span class="pre">lease_renewed</span></code>), pas par le fichier de bail ;</p></li>
<li><p>l’agent n’accepte <strong>qu’un seul disque virtio</strong> (le disque système) ; les autres sont des <code class="docutils literal notranslate"><span class="pre">sdX</span></code> ;</p></li>
<li><p>l’agent n’accepte <strong>qu’un seul disque virtio</strong> (le disque racine, <code class="docutils literal notranslate"><span class="pre">vda</span></code>) ; les autres sont des <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> ;</p></li>
<li><p>sur Debian 12, <code class="docutils literal notranslate"><span class="pre">ebtables</span> <span class="pre">-L</span></code> (nft) garde les zéros de tête des MAC ;</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> est posée en <code class="docutils literal notranslate"><span class="pre">/32</span></code> sur le bridge du netns en mode <code class="docutils literal notranslate"><span class="pre">bridge</span></code> ;</p></li>
<li><p>depuis le netns d’un hôte, une VM d’un autre hôte ne répond pas : la réponse repart vers la

File diff suppressed because one or more lines are too long

View file

@ -446,6 +446,18 @@ MAC dérivée du rang de l’IP donnait la même MAC à deux interfaces d’une
leurs subnets (VM injoignable), et n’était pas tenable en IPv6</p></li>
<li><p>Migration au démarrage : les VM existantes gardent leur MAC, recopiée sur chaque interface</p></li>
</ul>
<p><strong>Disques : <code class="docutils literal notranslate"><span class="pre">vda</span></code> pour la racine, <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> pour les autres (#74)</strong></p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">dev</span></code> accepte désormais <code class="docutils literal notranslate"><span class="pre">vda</span></code>, le disque racine virtio, et <code class="docutils literal notranslate"><span class="pre">xvda</span></code> à <code class="docutils literal notranslate"><span class="pre">xvdz</span></code> pour les disques
additionnels, sur la cible SCSI de même rang (<code class="docutils literal notranslate"><span class="pre">xvda</span></code> → 0). Toute autre valeur est refusée (400),
<code class="docutils literal notranslate"><span class="pre">sdX</span></code> compris</p></li>
<li><p>Chaque disque reçoit le numéro de série <code class="docutils literal notranslate"><span class="pre">&lt;dev&gt;</span></code>. Le noyau de l’invité nomme les disques SCSI
<code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code> dans l’ordre de détection, qui change d’un démarrage à l’autre (mesuré en lab : <code class="docutils literal notranslate"><span class="pre">sda</span></code>
et <code class="docutils literal notranslate"><span class="pre">sdb</span></code> inversés 4 démarrages sur 6). Le nom stable est <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code>, créé par une règle udev
de l’image (exigence décrite dans la documentation de construction d’image), et toujours
<code class="docutils literal notranslate"><span class="pre">/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX</span></code></p></li>
<li><p>Migration au démarrage : les clés <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/sdX</span></code> deviennent <code class="docutils literal notranslate"><span class="pre">vm/&lt;name&gt;/disk/xvdX</span></code></p></li>
</ul>
<p><strong>Exploitation</strong></p>
<ul class="simple">
<li><p>Le watchdog contrôle aussi, avec une section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> : les sessions vers les route reflectors ;
@ -528,7 +540,7 @@ bash<span class="w"> </span>./deploy.sh<span class="w"> </span>-t<span class="w"
</pre></div>
</div>
<p>Sans <code class="docutils literal notranslate"><span class="pre">dhcp.backend</span></code> ni <code class="docutils literal notranslate"><span class="pre">bgp</span></code> dans <code class="docutils literal notranslate"><span class="pre">/etc/two/agent.yml</span></code>, le comportement est celui de la 0.1.0, à
trois exceptions près, qui touchent les appelants de l’API :</p>
quatre exceptions près, qui touchent les appelants de l’API :</p>
<ul class="simple">
<li><p><strong><code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> ne se fournit plus pour un subnet <code class="docutils literal notranslate"><span class="pre">vxlan</span></code></strong> : il est refusé (400), l’agent le
calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières
@ -536,6 +548,9 @@ adresses utilisables du subnet. Il reste obligatoire en <code class="docutils li
<li><p><strong>un subnet encore utilisé par une VM ne se supprime plus</strong> : supprimer les VM d’abord</p></li>
<li><p><strong>chaque interface d’une VM doit porter sa <code class="docutils literal notranslate"><span class="pre">mac</span></code></strong> (400 sinon) : l’appelant la choisit et en
garantit l’unicité. Les VM existantes gardent la leur, recopiée au premier démarrage de l’agent</p></li>
<li><p><strong>les disques additionnels s’appellent <code class="docutils literal notranslate"><span class="pre">xvdX</span></code></strong> : <code class="docutils literal notranslate"><span class="pre">sdX</span></code> est refusé (400). Les VM existantes sont
migrées ; leurs disques prennent le numéro de série <code class="docutils literal notranslate"><span class="pre">xvdX</span></code> au prochain lancement, et une image
qui les montait par <code class="docutils literal notranslate"><span class="pre">/dev/sdY</span></code> doit passer à <code class="docutils literal notranslate"><span class="pre">/dev/xvdX</span></code></p></li>
</ul>
<p>Les subnets <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu’à leur recréation.</p>