Disques : le nom sdX dans l'invité ne suit pas le dev déclaré, numéro de série et doc #74

Closed
opened 2026-10-17 20:18:04 +00:00 by nicolas.boufideline · 5 comments

Constat

Campagne du 2026-10-17 (#70, 26-multi-disque) : VM déclarée avec sda (2 Gio) et sdb (1 Gio).

  • Une passe : noms corrects dans l'invité.
  • Passe suivante : inversés (/dev/sdb = 2 Gio, /dev/sda = 1 Gio).
  • Un seul disque déclaré sdb → vu en /dev/sda dans l'invité.

Cause

  • internal/qemu/start_linux.go traduit sdX en scsi-hd avec scsi-id = rang de la lettre (a → 0, b → 1). Ça, c'est correct : l'invité voit bien sda déclaré sur la cible 0 et sdb sur la cible 1 (vérifié en lab par lsblk -o HCTL).
  • Le noyau de l'invité nomme les disques SCSI dans l'ordre de détection, qui est asynchrone : /dev/sdX n'est pas stable, et l'hôte ne peut pas le fixer.
  • Côté virtio, un seul vdX est accepté (le disque système).

api/agent.yaml décrit dev comme « Device name inside the VM » : faux pour les disques SCSI.

Décision (2026-10-17)

  • Numéro de série : l'agent pose serial=<dev> sur chaque disque QEMU (scsi-hd et virtio-blk-pci). L'invité obtient un lien stable qui contient le nom déclaré sous /dev/disk/by-id/ (forme attendue : scsi-0QEMU_QEMU_HARDDISK_<dev> en SCSI, virtio-<dev> en virtio ; à relever exactement en lab). Test unitaire sur la ligne de commande QEMU.
  • Doc : api/agent.yaml (VMStorage.dev) et la doc utilisateur. dev désigne l'emplacement du disque (vda = disque système virtio, sdX = cible SCSI X), pas un nom garanti dans l'invité ; renvoyer vers /dev/disk/by-id/…<dev>.
  • e2e : 26-multi-disque vérifie les liens by-id au lieu des contrôles « nom dans l'invité = dev déclaré » (aujourd'hui en échec attendu).

Critère de clôture

26-multi-disque vert en lab, avec la forme exacte des liens by-id relevée et reportée dans la doc.

## Constat Campagne du 2026-10-17 (#70, `26-multi-disque`) : VM déclarée avec `sda` (2 Gio) et `sdb` (1 Gio). - Une passe : noms corrects dans l'invité. - Passe suivante : **inversés** (`/dev/sdb` = 2 Gio, `/dev/sda` = 1 Gio). - Un seul disque déclaré `sdb` → vu en `/dev/sda` dans l'invité. ## Cause - `internal/qemu/start_linux.go` traduit `sdX` en `scsi-hd` avec `scsi-id` = rang de la lettre (`a` → 0, `b` → 1). Ça, c'est correct : l'invité voit bien `sda` déclaré sur la cible 0 et `sdb` sur la cible 1 (vérifié en lab par `lsblk -o HCTL`). - Le noyau de l'invité nomme les disques SCSI **dans l'ordre de détection**, qui est asynchrone : `/dev/sdX` n'est pas stable, et l'hôte ne peut pas le fixer. - Côté virtio, un seul `vdX` est accepté (le disque système). `api/agent.yaml` décrit `dev` comme « Device name inside the VM » : **faux pour les disques SCSI**. ## Décision (2026-10-17) - **Numéro de série** : l'agent pose `serial=<dev>` sur chaque disque QEMU (`scsi-hd` et `virtio-blk-pci`). L'invité obtient un lien stable qui contient le nom déclaré sous `/dev/disk/by-id/` (forme attendue : `scsi-0QEMU_QEMU_HARDDISK_<dev>` en SCSI, `virtio-<dev>` en virtio ; à relever exactement en lab). Test unitaire sur la ligne de commande QEMU. - **Doc** : `api/agent.yaml` (`VMStorage.dev`) et la doc utilisateur. `dev` désigne l'emplacement du disque (`vda` = disque système virtio, `sdX` = cible SCSI X), pas un nom garanti dans l'invité ; renvoyer vers `/dev/disk/by-id/…<dev>`. - **e2e** : `26-multi-disque` vérifie les liens `by-id` au lieu des contrôles « nom dans l'invité = dev déclaré » (aujourd'hui en échec attendu). ## Critère de clôture `26-multi-disque` vert en lab, avec la forme exacte des liens `by-id` relevée et reportée dans la doc.
Author
Owner

Marqueurs d'échec connu dans la suite e2e (#70)

En attendant ce correctif, ces contrôles de la suite e2e sont marqués comme échec connu rattaché à ce ticket (branche feature-70) :

Fichier Contrôle Marqueur
test/e2e/suite/26-multi-disque.sh t26-d : nom dans l'invité = dev déclaré, sdb de 1 Gio known_flaky
test/e2e/suite/26-multi-disque.sh t26-d : nom dans l'invité = dev déclaré, sda de 2 Gio known_flaky

À retirer avec ce correctif : remplacer le marqueur (known "#74" ou known_flaky "#74", suivi de la description) par check dans les fichiers ci-dessus, puis vérifier en lab que les contrôles passent.

  • known_flaky (échec intermittent) : aucun rappel automatique, le contrôle sort en RÉUSSI quand l'échec ne se reproduit pas. Le retrait doit être fait à la main en fermant ce ticket.

Une fois les liens by-id en place, ces deux contrôles seront remplacés par la vérification des liens /dev/disk/by-id/…<dev> (cf. décision ci-dessus), et non simplement démarqués.

run.sh --connus compte les contrôles connus comme des échecs, pour voir l'état brut.

## Marqueurs d'échec connu dans la suite e2e (#70) En attendant ce correctif, ces contrôles de la suite e2e sont marqués comme échec connu rattaché à ce ticket (branche `feature-70`) : | Fichier | Contrôle | Marqueur | |---|---|---| | `test/e2e/suite/26-multi-disque.sh` | t26-d : nom dans l'invité = dev déclaré, sdb de 1 Gio | `known_flaky` | | `test/e2e/suite/26-multi-disque.sh` | t26-d : nom dans l'invité = dev déclaré, sda de 2 Gio | `known_flaky` | **À retirer avec ce correctif** : remplacer le marqueur (`known "#74"` ou `known_flaky "#74"`, suivi de la description) par `check` dans les fichiers ci-dessus, puis vérifier en lab que les contrôles passent. - `known_flaky` (échec intermittent) : **aucun rappel automatique**, le contrôle sort en `RÉUSSI` quand l'échec ne se reproduit pas. Le retrait doit être fait à la main en fermant ce ticket. Une fois les liens `by-id` en place, ces deux contrôles seront remplacés par la vérification des liens `/dev/disk/by-id/…<dev>` (cf. décision ci-dessus), et non simplement démarqués. `run.sh --connus` compte les contrôles connus comme des échecs, pour voir l'état brut.
Author
Owner

Lab du 2026-10-22 : branche feature-74 (afd9238) validée

Arbre testé : main + feature-73 + feature-74, evpn-3hv, labctl 0.2.0.

Suite e2e

26-multi-disque : 19/19, sans marqueur known_flaky. Les liens by-id contrôlés pointent sur le bon disque (taille) et sur le disque système.

Forme exacte des liens (relevée par udevadm info)

Disque Variables udev Lien
SCSI sdX ID_SERIAL=0QEMU_QEMU_HARDDISK_sdX, ID_SERIAL_SHORT=sdX, ID_SCSI_SERIAL=sdX /dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_sdX
virtio vda ID_SERIAL=vda, pas d'ID_SERIAL_SHORT /dev/disk/by-id/virtio-vda

Ce sont les formes déjà écrites dans la doc et dans api/agent.yaml : rien à corriger.

Ordre des noms dans l'invité (VM vda + sda 2 Gio + sdb 1 Gio, Debian 12)

  • Sans option : sda/sdb inversés 4 démarrages sur 6. Les liens par numéro de série sont restés justes à chaque fois.
  • scsi_mod.scan=sync sur la ligne du noyau : dans l'ordre 5 fois sur 5. Ce n'est pas une garantie : l'échantillon est petit, et un disque déclaré seul en sdb reste /dev/sda.

Règle udev /dev/two/<dev> (essai, non retenue pour l'instant)

udev ne peut pas renommer un disque (udev(7) : « The name of a device node cannot be changed by udev, only additional symlinks can be created »). En revanche, ces deux lignes créent des liens /dev/two/<dev> qui sont restés justes après redémarrage, y compris pour un sdb déclaré seul (/dev/two/sdb → /dev/sda) :

SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL_SHORT}=="sd[a-z]", SYMLINK+="two/$env{ID_SERIAL_SHORT}"
SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", KERNEL=="vd*", ENV{ID_SERIAL}=="vd[a-z]", SYMLINK+="two/$env{ID_SERIAL}"

La seconde ligne est nécessaire pour virtio (pas d'ID_SERIAL_SHORT). Nommage d'un chemin simple dans l'image : en discussion (/dev/xvdX envisagé).

## Lab du 2026-10-22 : branche `feature-74` (`afd9238`) validée Arbre testé : main + feature-73 + feature-74, evpn-3hv, labctl 0.2.0. ### Suite e2e `26-multi-disque` : 19/19, sans marqueur `known_flaky`. Les liens `by-id` contrôlés pointent sur le bon disque (taille) et sur le disque système. ### Forme exacte des liens (relevée par `udevadm info`) | Disque | Variables udev | Lien | |---|---|---| | SCSI `sdX` | `ID_SERIAL=0QEMU_QEMU_HARDDISK_sdX`, `ID_SERIAL_SHORT=sdX`, `ID_SCSI_SERIAL=sdX` | `/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_sdX` | | virtio `vda` | `ID_SERIAL=vda`, pas d'`ID_SERIAL_SHORT` | `/dev/disk/by-id/virtio-vda` | Ce sont les formes déjà écrites dans la doc et dans `api/agent.yaml` : rien à corriger. ### Ordre des noms dans l'invité (VM `vda` + `sda` 2 Gio + `sdb` 1 Gio, Debian 12) - Sans option : `sda`/`sdb` **inversés 4 démarrages sur 6**. Les liens par numéro de série sont restés justes à chaque fois. - `scsi_mod.scan=sync` sur la ligne du noyau : dans l'ordre 5 fois sur 5. Ce n'est pas une garantie : l'échantillon est petit, et un disque déclaré seul en `sdb` reste `/dev/sda`. ### Règle udev `/dev/two/<dev>` (essai, non retenue pour l'instant) udev ne peut pas renommer un disque (`udev(7)` : « The name of a device node cannot be changed by udev, only additional symlinks can be created »). En revanche, ces deux lignes créent des liens `/dev/two/<dev>` qui sont restés justes après redémarrage, y compris pour un `sdb` déclaré seul (`/dev/two/sdb` → `/dev/sda`) : ``` SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_SERIAL_SHORT}=="sd[a-z]", SYMLINK+="two/$env{ID_SERIAL_SHORT}" SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", KERNEL=="vd*", ENV{ID_SERIAL}=="vd[a-z]", SYMLINK+="two/$env{ID_SERIAL}" ``` La seconde ligne est nécessaire pour virtio (pas d'`ID_SERIAL_SHORT`). Nommage d'un chemin simple dans l'image : en discussion (`/dev/xvdX` envisagé).
Author
Owner

Décision (2026-10-23) : vda pour la racine, xvdX pour les disques additionnels

Elle complète la décision du 2026-10-17. Le numéro de série seul laissait à l'utilisateur un nom long (by-id). On veut un chemin simple et prévisible dans l'invité.

  • API : dev vaut vda, le disque racine virtio (vu /dev/vda, démarré en premier), ou xvda à xvdz pour un disque additionnel, sur la cible SCSI de même rang (xvda → 0). Toute autre valeur donne un 400, sdX compris.
  • Numéro de série = dev, comme avant. Dans l'invité, le noyau nomme toujours les disques SCSI /dev/sdY dans l'ordre de détection (inversés 4 démarrages sur 6 en lab, 1221). Le nom stable est /dev/xvdX, créé par une règle udev qui devient une exigence d'image (90-two-xvd.rules, disques et partitions). /dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX reste disponible sans règle. xvd est le préfixe des disques Xen : il n'existe pas dans une VM KVM, donc pas de conflit en pratique.
  • Migration au démarrage de l'agent : vm/<name>/disk/sdX → vm/<name>/disk/xvdX (même lettre, même cible). Si xvdX existe déjà avec un autre chemin, le démarrage échoue en nommant la clé. Un disque prend le numéro de série xvdX au prochain lancement de sa VM.
  • Changement cassant pour les appelants, ajouté aux notes de version 0.2.0.

Implémentation (feature-74, non poussée)

  • 98127ee api : validation ^(vda|xvd[a-z])$, QEMU xvdX → scsi-hd cible X, internal/migration/disk.go appelée au démarrage. 7 mutants tués.
  • b1b31f3 e2e : two_image pose la règle udev ; 26-multi-disque vérifie /dev/xvdX, les liens by-id et une partition /dev/xvdb1 ; 11-validation refuse sdb, vdb, xvdaa.
  • 44fdeeb doc : API, stockage (migration), contraintes, premier VPC, concepts, construction d'image, notes de version.

Reste avant clôture

Lab : 26 et 11. La règle udev des partitions n'a pas encore tourné, et il reste à vérifier la présence de sfdisk dans l'image Debian.

## Décision (2026-10-23) : `vda` pour la racine, `xvdX` pour les disques additionnels Elle complète la décision du 2026-10-17. Le numéro de série seul laissait à l'utilisateur un nom long (`by-id`). On veut un chemin simple et prévisible dans l'invité. - **API** : `dev` vaut `vda`, le disque racine virtio (vu `/dev/vda`, démarré en premier), ou `xvda` à `xvdz` pour un disque additionnel, sur la cible SCSI de même rang (`xvda` → 0). Toute autre valeur donne un **400**, `sdX` compris. - **Numéro de série** = `dev`, comme avant. Dans l'invité, le noyau nomme toujours les disques SCSI `/dev/sdY` dans l'ordre de détection (inversés 4 démarrages sur 6 en lab, 1221). Le nom stable est **`/dev/xvdX`**, créé par une règle udev qui devient une exigence d'image (`90-two-xvd.rules`, disques et partitions). `/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX` reste disponible sans règle. `xvd` est le préfixe des disques Xen : il n'existe pas dans une VM KVM, donc pas de conflit en pratique. - **Migration** au démarrage de l'agent : `vm/<name>/disk/sdX` → `vm/<name>/disk/xvdX` (même lettre, même cible). Si `xvdX` existe déjà avec un autre chemin, le démarrage échoue en nommant la clé. Un disque prend le numéro de série `xvdX` au prochain lancement de sa VM. - Changement cassant pour les appelants, ajouté aux notes de version 0.2.0. ### Implémentation (`feature-74`, non poussée) - `98127ee` api : validation `^(vda|xvd[a-z])$`, QEMU `xvdX` → `scsi-hd` cible X, `internal/migration/disk.go` appelée au démarrage. 7 mutants tués. - `b1b31f3` e2e : `two_image` pose la règle udev ; `26-multi-disque` vérifie `/dev/xvdX`, les liens `by-id` et une partition `/dev/xvdb1` ; `11-validation` refuse `sdb`, `vdb`, `xvdaa`. - `44fdeeb` doc : API, stockage (migration), contraintes, premier VPC, concepts, construction d'image, notes de version. ### Reste avant clôture Lab : `26` et `11`. La règle udev des partitions n'a pas encore tourné, et il reste à vérifier la présence de `sfdisk` dans l'image Debian.
Author
Owner

Lab du 2026-10-23 : vda / xvdX validés

Campagne du 2026-10-23 (evpn-3hv, labctl 0.2.0) sur l'arbre combiné main + feature-56 (qui contient feature-74) + feature-75, suite complète run.sh --continue all : tout vert sauf un contrôle de 12-etats (socket monitor de t12-err restée, intermittent connu, 28/28 au rejeu).

  • 26-multi-disque : 21/21. Les liens /dev/xvda et /dev/xvdb (règle udev de l'image) et by-id scsi-0QEMU_QEMU_HARDDISK_xvdX pointent sur le bon disque (taille), virtio-vda sur le disque racine. La règle des partitions fonctionne (/dev/xvdb1 après sfdisk, qui est présent dans l'image Debian 12) ; écriture sur /dev/xvda et /dev/xvdb1.
  • 11-validation : 45/45. Un disque additionnel sdb, vdb ou xvdaa est refusé en 400.
  • Le reste de la suite, toutes les VM utilisant la nouvelle ligne QEMU, est vert.

Reste avant clôture : fusion de feature-74.

## Lab du 2026-10-23 : `vda` / `xvdX` validés Campagne du 2026-10-23 (evpn-3hv, labctl 0.2.0) sur l'arbre combiné main + feature-56 (qui contient feature-74) + feature-75, suite complète `run.sh --continue all` : tout vert sauf un contrôle de `12-etats` (socket monitor de t12-err restée, intermittent connu, 28/28 au rejeu). - `26-multi-disque` : 21/21. Les liens `/dev/xvda` et `/dev/xvdb` (règle udev de l'image) et `by-id` `scsi-0QEMU_QEMU_HARDDISK_xvdX` pointent sur le bon disque (taille), `virtio-vda` sur le disque racine. La **règle des partitions** fonctionne (`/dev/xvdb1` après `sfdisk`, qui est présent dans l'image Debian 12) ; écriture sur `/dev/xvda` et `/dev/xvdb1`. - `11-validation` : 45/45. Un disque additionnel `sdb`, `vdb` ou `xvdaa` est refusé en 400. - Le reste de la suite, toutes les VM utilisant la nouvelle ligne QEMU, est vert. Reste avant clôture : fusion de `feature-74`.
Author
Owner

Clôture

Fusionné dans main (91cf5e3). Validé en lab le 2026-10-23 : 26-multi-disque 21/21 et 11-validation 45/45 (1228).

Livré :

  • dev vaut vda (disque racine virtio) ou xvd[a-z] (cible SCSI de même rang) ; sdX est refusé (400) ;
  • migration disk/sdX → disk/xvdX au démarrage de l'agent ;
  • le numéro de série vaut dev, et la règle udev d'image crée /dev/xvdX et /dev/xvdXN ; le lien by-id scsi-0QEMU_QEMU_HARDDISK_xvdX reste disponible ;
  • la doc et les notes de version (changement cassant pour les appelants).
## Clôture Fusionné dans `main` (`91cf5e3`). Validé en lab le 2026-10-23 : `26-multi-disque` 21/21 et `11-validation` 45/45 (1228). Livré : - `dev` vaut `vda` (disque racine virtio) ou `xvd[a-z]` (cible SCSI de même rang) ; `sdX` est refusé (400) ; - migration `disk/sdX` → `disk/xvdX` au démarrage de l'agent ; - le numéro de série vaut `dev`, et la règle udev d'image crée `/dev/xvdX` et `/dev/xvdXN` ; le lien `by-id` `scsi-0QEMU_QEMU_HARDDISK_xvdX` reste disponible ; - la doc et les notes de version (changement cassant pour les appelants).
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
syonad/two#74
No description provided.