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:
parent
096ee1dc0e
commit
9b5b4a6e62
4 changed files with 18 additions and 5 deletions
|
|
@ -566,7 +566,12 @@ components:
|
||||||
example: /var/lib/two/volumes/abc.qcow2
|
example: /var/lib/two/volumes/abc.qcow2
|
||||||
dev:
|
dev:
|
||||||
type: string
|
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]$'
|
pattern: '^[sv]d[a-z]$'
|
||||||
example: vda
|
example: vda
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
**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
|
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ù
|
Ce qui est stocké, et où
|
||||||
------------------------
|
------------------------
|
||||||
|
|
|
||||||
|
|
@ -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}],
|
"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"}]}'
|
"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**
|
``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
|
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
|
Les disques supplémentaires passent par ``sdX``. La carte PCI en dépend — voir
|
||||||
:doc:`/architecture/contraintes`.
|
: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
|
4. Vérifier
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -320,9 +320,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé
|
||||||
- hv1
|
- hv1
|
||||||
- #33, #62, #73
|
- #33, #62, #73
|
||||||
* - ``26-multi-disque``
|
* - ``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
|
- hv1
|
||||||
- #32
|
- #32, #74
|
||||||
* - ``27-reboot``
|
* - ``27-reboot``
|
||||||
- redémarrage d'une VM depuis l'invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué
|
- redémarrage d'une VM depuis l'invité — même processus QEMU, même adresse, nouveau bail, user_data non rejoué
|
||||||
- hv1
|
- hv1
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue