f-74: doc: vda racine, xvdX additionnels et /dev/xvdX par règle udev d'image, migration, notes de version #74

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-23 00:26:47 +02:00
commit d1b50d546c
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
8 changed files with 64 additions and 23 deletions

View file

@ -87,6 +87,18 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
leurs subnets (VM injoignable), et n'était pas tenable en IPv6
- Migration au démarrage : les VM existantes gardent leur MAC, recopiée sur chaque interface
**Disques : `vda` pour la racine, `xvdX` pour les autres (#74)**
- `dev` accepte désormais `vda`, le disque racine virtio, et `xvda` à `xvdz` pour les disques
additionnels, sur la cible SCSI de même rang (`xvda` → 0). Toute autre valeur est refusée (400),
`sdX` compris
- Chaque disque reçoit le numéro de série `<dev>`. Le noyau de l'invité nomme les disques SCSI
`/dev/sdY` dans l'ordre de détection, qui change d'un démarrage à l'autre (mesuré en lab : `sda`
et `sdb` inversés 4 démarrages sur 6). Le nom stable est `/dev/xvdX`, créé par une règle udev
de l'image (exigence décrite dans la documentation de construction d'image), et toujours
`/dev/disk/by-id/scsi-0QEMU_QEMU_HARDDISK_xvdX`
- Migration au démarrage : les clés `vm/<name>/disk/sdX` deviennent `vm/<name>/disk/xvdX`
**Exploitation**
- Le watchdog contrôle aussi, avec une section `bgp` : les sessions vers les route reflectors ;
@ -164,7 +176,7 @@ bash ./deploy.sh -t 0.2.0
```
Sans `dhcp.backend` ni `bgp` dans `/etc/two/agent.yml`, le comportement est celui de la 0.1.0, à
trois exceptions près, qui touchent les appelants de l'API :
quatre exceptions près, qui touchent les appelants de l'API :
- **`interface_ip` ne se fournit plus pour un subnet `vxlan`** : 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
@ -172,6 +184,9 @@ trois exceptions près, qui touchent les appelants de l'API :
- **un subnet encore utilisé par une VM ne se supprime plus** : supprimer les VM d'abord
- **chaque interface d'une VM doit porter sa `mac`** (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
- **les disques additionnels s'appellent `xvdX`** : `sdX` est refusé (400). Les VM existantes sont
migrées ; leurs disques prennent le numéro de série `xvdX` au prochain lancement, et une image
qui les montait par `/dev/sdY` doit passer à `/dev/xvdX`
Les subnets `vxlan` existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu'à leur recréation.