docs: build de 91cf5e3323
This commit is contained in:
parent
a8c48b268d
commit
bb924859e0
8 changed files with 54 additions and 12 deletions
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -380,7 +380,7 @@ vm/<name>/nic/<i>/mac → <mac> (fournie par
|
|||
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>/disk/<dev> → <path> (une clé par disque : vda, xvda, xvdb, …)
|
||||
vm/<name>/memory → <int> (Mo)
|
||||
vm/<name>/cpus → <int>
|
||||
vm/<name>/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/<name>/disk/sdX</span></code> en <code class="docutils literal notranslate"><span class="pre">vm/<name>/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>
|
||||
|
|
|
|||
|
|
@ -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/…<dev></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>
|
||||
|
|
|
|||
|
|
@ -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"><dev></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">
|
||||
|
|
|
|||
|
|
@ -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"><< 'ENDFILE' > /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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
|
@ -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"><dev></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/<name>/disk/sdX</span></code> deviennent <code class="docutils literal notranslate"><span class="pre">vm/<name>/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>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue