MAC des VM fournie à la création, fin du préchargement par subnet #62

Closed
opened 2026-10-12 13:04:01 +00:00 by nicolas.boufideline · 3 comments

Constat

La MAC d'une VM est aujourd'hui dérivée de son IP et préchargée : à la création d'un
subnet, dhcp.Entries (internal/dhcp/generate.go) parcourt toutes les adresses du cidr et
écrit une clé subnet/<nom>/dhcp/<ip> = 00:22:33:<rang sur 24 bits> par adresse ; la VM lit sa
MAC avec dhcp.GetMACForIP. Conséquences :

  • impossible en IPv6 : un /64 ferait 2^64 itérations ;
  • deux subnets partageant un segment L2 donnent la même MAC à des IP de même rang — bloquant pour
    les IP publiques (#31), où une plage partagée en L2 entre subnets est attendue ;
  • la MAC n'est pas un choix de l'appelant, alors que l'IP l'est.

Décision (2026-10-12)

La MAC est fournie par l'appelant dans POST /vms, un champ mac par interface, comme l'IP.
Son unicité relève de l'appelant (API machine-to-machine, validation en amont).

À faire

  • API : mac obligatoire par interface (api/agent.yaml, models.go), rendue par GET.
  • KV : vm/<nom>/nic/<i>/mac ; plus de table subnet/<nom>/dhcp/<ip> préchargée.
  • DHCP : réservations construites à partir des NIC des VM (backend two et dnsmasq tant qu'il
    existe, #49) au lieu du parcours du cidr ; dhcp.Entries et GetMACForIP retirés ou réécrits.
  • VM : la MAC de la NIC QEMU vient de vm/<nom>/nic/<i>/mac.
  • Watchdog DHCP (check_dhcp.go) : comparer aux NIC des VM.
  • Migration au démarrage (internal/migration) : pour chaque NIC existante, recopier la MAC
    depuis l'ancienne table, puis supprimer les clés subnet/<nom>/dhcp/*. Idempotente.
  • Docs : stockage.rst, concepts, notes de version.

Critère de clôture

Tests unitaires (dont migration) ; scénarios e2e repassés avec des MAC fournies ; une VM dont la
MAC n'a aucun lien avec le rang de son IP reçoit bien son bail.

Prépare #31 et #63 (IPv6 dual-stack).

## Constat La MAC d'une VM est aujourd'hui **dérivée de son IP** et **préchargée** : à la création d'un subnet, `dhcp.Entries` (`internal/dhcp/generate.go`) parcourt toutes les adresses du `cidr` et écrit une clé `subnet/<nom>/dhcp/<ip> = 00:22:33:<rang sur 24 bits>` par adresse ; la VM lit sa MAC avec `dhcp.GetMACForIP`. Conséquences : - impossible en IPv6 : un /64 ferait 2^64 itérations ; - deux subnets partageant un segment L2 donnent la même MAC à des IP de même rang — bloquant pour les IP publiques (#31), où une plage partagée en L2 entre subnets est attendue ; - la MAC n'est pas un choix de l'appelant, alors que l'IP l'est. ## Décision (2026-10-12) La MAC est **fournie par l'appelant** dans `POST /vms`, un champ `mac` par interface, comme l'IP. Son unicité relève de l'appelant (API machine-to-machine, validation en amont). ## À faire - API : `mac` obligatoire par interface (`api/agent.yaml`, `models.go`), rendue par GET. - KV : `vm/<nom>/nic/<i>/mac` ; plus de table `subnet/<nom>/dhcp/<ip>` préchargée. - DHCP : réservations construites à partir des NIC des VM (backend `two` et dnsmasq tant qu'il existe, #49) au lieu du parcours du `cidr` ; `dhcp.Entries` et `GetMACForIP` retirés ou réécrits. - VM : la MAC de la NIC QEMU vient de `vm/<nom>/nic/<i>/mac`. - Watchdog DHCP (`check_dhcp.go`) : comparer aux NIC des VM. - **Migration** au démarrage (`internal/migration`) : pour chaque NIC existante, recopier la MAC depuis l'ancienne table, puis supprimer les clés `subnet/<nom>/dhcp/*`. Idempotente. - Docs : stockage.rst, concepts, notes de version. ## Critère de clôture Tests unitaires (dont migration) ; scénarios e2e repassés avec des MAC fournies ; une VM dont la MAC n'a aucun lien avec le rang de son IP reçoit bien son bail. Prépare #31 et #63 (IPv6 dual-stack).
Author
Owner

Constat en lab du 2026-10-17 (#70) : VM multi-NIC — avancé en 0.2.0

La dérivation de la MAC depuis le rang de l'IP casse aussi les VM à plusieurs interfaces (#33) : deux NIC d'une même VM dont les adresses ont le même rang dans leur subnet reçoivent la même MAC.

  • Première passe de 25-multi-nic : NIC en 10.25.1.10 et 10.25.2.10 → deux fois mac=00:22:33:00:00:0A sur la ligne QEMU (virtio-net-pci,netdev=net0,mac=00:22:33:00:00:0A et netdev=net1,mac=00:22:33:00:00:0A). La VM est entièrement injoignable, même sur sa primaire.
  • Le contrôle est désormais explicite dans test/e2e/suite/25-multi-nic.sh : VM t25-r en 10.25.1.30 / 10.25.2.30, « deux NIC de même rang reçoivent des MAC distinctes » — en échec tant que ce ticket n'est pas fait. Le reste du test utilise des rangs différents.
  • Impact limité aux VM multi-NIC : pour des VM différentes dans des subnets différents, la même MAC est sans effet (une table de MAC par VNI en EVPN).

Décision (2026-10-17) : ce ticket passe en milestone 0.2.0, pour que le multi-NIC soit fiable dans cette version. La décision du 2026-10-12 (MAC fournie par l'appelant, champ mac par interface, fin de la table préchargée, migration) reste le plan.

Critère ajouté : 25-multi-nic vert en lab, y compris le contrôle t25-r.

## Constat en lab du 2026-10-17 (#70) : VM multi-NIC — avancé en 0.2.0 La dérivation de la MAC depuis le rang de l'IP casse aussi les **VM à plusieurs interfaces** (#33) : deux NIC d'une même VM dont les adresses ont le même rang dans leur subnet reçoivent la **même MAC**. - Première passe de `25-multi-nic` : NIC en `10.25.1.10` et `10.25.2.10` → deux fois `mac=00:22:33:00:00:0A` sur la ligne QEMU (`virtio-net-pci,netdev=net0,mac=00:22:33:00:00:0A` et `netdev=net1,mac=00:22:33:00:00:0A`). La VM est **entièrement injoignable**, même sur sa primaire. - Le contrôle est désormais explicite dans `test/e2e/suite/25-multi-nic.sh` : VM `t25-r` en `10.25.1.30` / `10.25.2.30`, « deux NIC de même rang reçoivent des MAC distinctes » — **en échec** tant que ce ticket n'est pas fait. Le reste du test utilise des rangs différents. - Impact limité aux VM multi-NIC : pour des VM différentes dans des subnets différents, la même MAC est sans effet (une table de MAC par VNI en EVPN). **Décision (2026-10-17) : ce ticket passe en milestone 0.2.0**, pour que le multi-NIC soit fiable dans cette version. La décision du 2026-10-12 (MAC fournie par l'appelant, champ `mac` par interface, fin de la table préchargée, migration) reste le plan. Critère ajouté : `25-multi-nic` vert en lab, y compris le contrôle `t25-r`.
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/25-multi-nic.sh t25-r : deux NIC de même rang reçoivent des MAC distinctes known

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

  • known : tant que l'échec persiste, le contrôle sort en CONNU sans faire échouer le test ; dès qu'il passe, il sort en INATTENDU et fait échouer le test — c'est le rappel automatique de retirer le marqueur.

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/25-multi-nic.sh` | t25-r : deux NIC de même rang reçoivent des MAC distinctes | `known` | **À retirer avec ce correctif** : remplacer le marqueur (`known "#62"` ou `known_flaky "#62"`, suivi de la description) par `check` dans les fichiers ci-dessus, puis vérifier en lab que les contrôles passent. - `known` : tant que l'échec persiste, le contrôle sort en `CONNU` sans faire échouer le test ; **dès qu'il passe, il sort en `INATTENDU` et fait échouer le test** — c'est le rappel automatique de retirer le marqueur. `run.sh --connus` compte les contrôles connus comme des échecs, pour voir l'état brut.
Author
Owner

Bilan de clôture

Correctif (dans main par 9a6c948) :

  • 0771414 : champ mac obligatoire par interface dans POST /vms (400 sinon), stocké vm/<nom>/nic/<i>/mac, rendu par GET, passé tel quel à QEMU et à la réservation DHCP ; fin de dhcp.Entries, StoreDHCPEntries, GetMACForIP et de la table subnet/<nom>/dhcp/<ip> ; migration MigrateVMMACs au démarrage (VM deleted ignorées, table supprimée seulement après copie complète, échec rejouable) ; api/agent.yaml.
  • 11eb7f2 : harnais — MAC 52:54:00 + trois derniers octets de l'IP, --nic sn=ip=mac ; 21 : VM à MAC arbitraire ; 11 : interface sans mac refusée ; 25 : known "#62" → check.
  • 62e73e9 : doc (stockage, concepts, exemples, notes 0.2.0 dont la rupture d'API).

Vérifications : 8 tests unitaires ajoutés (dont 5 pour la migration), 9 mutants tués.

Lab du 2026-10-19 : 21-dhcp-two (t21-m, MAC 02:de:ad:be:ef:01 sans lien avec son IP : joignable, MAC vue dans l'invité, bail servi par la gateway, MAC rendue par l'API), 25-multi-nic (t25-r, deux NIC de même rang → MAC distinctes), 11-validation (interface sans mac → 400) : verts.

Suite : l'attribution des MAC par l'appelant (pools, préfixes, quarantaine) est décrite sur #71 (commentaire 1154).

## Bilan de clôture **Correctif** (dans main par `9a6c948`) : - `0771414` : champ `mac` obligatoire par interface dans `POST /vms` (400 sinon), stocké `vm/<nom>/nic/<i>/mac`, rendu par GET, passé tel quel à QEMU et à la réservation DHCP ; fin de `dhcp.Entries`, `StoreDHCPEntries`, `GetMACForIP` et de la table `subnet/<nom>/dhcp/<ip>` ; migration `MigrateVMMACs` au démarrage (VM `deleted` ignorées, table supprimée seulement après copie complète, échec rejouable) ; `api/agent.yaml`. - `11eb7f2` : harnais — MAC `52:54:00` + trois derniers octets de l'IP, `--nic sn=ip=mac` ; 21 : VM à MAC arbitraire ; 11 : interface sans mac refusée ; 25 : `known "#62"` → `check`. - `62e73e9` : doc (stockage, concepts, exemples, notes 0.2.0 dont la rupture d'API). **Vérifications** : 8 tests unitaires ajoutés (dont 5 pour la migration), 9 mutants tués. **Lab du 2026-10-19** : `21-dhcp-two` (t21-m, MAC `02:de:ad:be:ef:01` sans lien avec son IP : joignable, MAC vue dans l'invité, bail servi par la gateway, MAC rendue par l'API), `25-multi-nic` (t25-r, deux NIC de même rang → MAC distinctes), `11-validation` (interface sans mac → 400) : verts. Suite : l'attribution des MAC par l'appelant (pools, préfixes, quarantaine) est décrite sur #71 (commentaire 1154).
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#62
No description provided.