From afd9238ce43a0da6930d740a9efd3f1ec1789e86 Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Thu, 22 Oct 2026 22:52:12 +0200 Subject: [PATCH] =?UTF-8?q?f-74:=20doc:=20dev=20d=C3=A9signe=20l'emplaceme?= =?UTF-8?q?nt=20du=20disque,=20nom=20stable=20sous=20/dev/disk/by-id=20#74?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- api/agent.yaml | 7 ++++++- docs/concepts/vpc-subnet-vm.rst | 4 +++- docs/demarrage/premier-vpc.rst | 8 +++++++- docs/developpement/lab.rst | 4 ++-- 4 files changed, 18 insertions(+), 5 deletions(-) diff --git a/api/agent.yaml b/api/agent.yaml index 04502fd..26b223e 100644 --- a/api/agent.yaml +++ b/api/agent.yaml @@ -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-, scsi-0QEMU_QEMU_HARDDISK_). pattern: '^[sv]d[a-z]$' example: vda diff --git a/docs/concepts/vpc-subnet-vm.rst b/docs/concepts/vpc-subnet-vm.rst index 8dcf2b7..212225e 100644 --- a/docs/concepts/vpc-subnet-vm.rst +++ b/docs/concepts/vpc-subnet-vm.rst @@ -96,7 +96,9 @@ subnet — l'ordre qui évite le trou noir de `#41 ``. Ce qui est stocké, et où ------------------------ diff --git a/docs/demarrage/premier-vpc.rst b/docs/demarrage/premier-vpc.rst index 562978f..3d3b2de 100644 --- a/docs/demarrage/premier-vpc.rst +++ b/docs/demarrage/premier-vpc.rst @@ -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 ```` ; le nom stable est sous ``/dev/disk/by-id/`` : + ``scsi-0QEMU_QEMU_HARDDISK_sdb``, ``virtio-vda``. + 4. Vérifier ----------- diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index a0ffd74..22288c1 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -320,9 +320,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - hv1 - #33, #62 * - ``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