f-74: doc: dev désigne l'emplacement du disque, nom stable sous /dev/disk/by-id #74

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-22 22:52:12 +02:00
commit 9b5b4a6e62
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
4 changed files with 18 additions and 5 deletions

View file

@ -566,7 +566,12 @@ components:
example: /var/lib/two/volumes/abc.qcow2
dev:
type: string
description: Device name inside the VM
description: >-
Disk slot: vda is the virtio-blk system disk (one at most), sdX
is SCSI target X (a → 0). Not a guaranteed name inside the VM:
the guest kernel names SCSI disks in detection order. The disk
serial is set to dev, so the guest finds it under
/dev/disk/by-id/ (virtio-<dev>, scsi-0QEMU_QEMU_HARDDISK_<dev>).
pattern: '^[sv]d[a-z]$'
example: vda

View file

@ -96,7 +96,9 @@ subnet — l'ordre qui évite le trou noir de `#41 <https://git.g3e.fr/syonad/tw
**Stockage.** Un seul disque ``vdX`` (virtio-blk) par VM ; les disques supplémentaires passent
par le contrôleur SCSI (``sdX``). Cette contrainte vient de la carte PCI figée — voir
:doc:`/architecture/contraintes`.
:doc:`/architecture/contraintes`. ``dev`` fixe l'emplacement du disque (cible SCSI, slot PCI)
et son numéro de série, pas son nom dans le guest : le disque se retrouve par
``/dev/disk/by-id/…<dev>``.
Ce qui est stocké, et où
------------------------

View file

@ -96,7 +96,7 @@ Là encore, attendez ``running`` :
"interfaces": [{"subnet": "sn-000001", "ip": "10.1.1.2", "mac": "52:54:00:01:01:02", "primary": true}],
"storage": [{"path": "/var/lib/two/volumes/i-web.qcow2", "dev": "vda"}]}'
Quatre points qui coûtent du temps quand on les découvre en production :
Six points qui coûtent du temps quand on les découvre en production :
``user_data`` est **encodé en base64**
Un base64 invalide est rejeté en 400 plutôt que servi vide. L'agent n'interprète jamais ce
@ -119,6 +119,12 @@ Un seul disque ``vdX``
Les disques supplémentaires passent par ``sdX``. La carte PCI en dépend — voir
:doc:`/architecture/contraintes`.
``dev`` désigne un emplacement, pas un nom dans le guest
``sdb`` est la cible SCSI 1, mais le noyau du guest nomme les disques SCSI dans l'ordre de
détection : ``/dev/sdb`` peut être un autre disque. L'agent donne à chaque disque le numéro
de série ``<dev>`` ; le nom stable est sous ``/dev/disk/by-id/`` :
``scsi-0QEMU_QEMU_HARDDISK_sdb``, ``virtio-vda``.
4. Vérifier
-----------

View file

@ -320,9 +320,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé
- hv1
- #33, #62, #73
* - ``26-multi-disque``
- VM à plusieurs disques — virtio (vdX) et SCSI (sdX), tailles et bus vus par la VM, démarrage sur vda
- VM à plusieurs disques — virtio (vdX) et SCSI (sdX), tailles et bus vus par la VM, liens ``by-id`` par numéro de série, démarrage sur vda
- hv1
- #32
- #32, #74
* - ``27-reboot``
- redémarrage d'une VM depuis l'invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué
- hv1