From 85320fce0e3212424f618ecee90c22aff89689ff Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Sat, 31 Oct 2026 21:26:10 +0100 Subject: [PATCH] =?UTF-8?q?f-95:=20doc:=20MAC=20fig=C3=A9e=20sur=20le=20ta?= =?UTF-8?q?p,=20notes=200.3.0=20#95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- docs/architecture/contraintes.rst | 3 +++ docs/concepts/vpc-subnet-vm.rst | 9 +++++++++ docs/developpement/lab.rst | 8 ++++---- docs/exploitation/diagnostic.rst | 10 ++++++++++ release_notes/0.3.0.md | 12 ++++++++++++ 5 files changed, 38 insertions(+), 4 deletions(-) diff --git a/docs/architecture/contraintes.rst b/docs/architecture/contraintes.rst index f52c219..6e13829 100644 --- a/docs/architecture/contraintes.rst +++ b/docs/architecture/contraintes.rst @@ -59,6 +59,9 @@ QEMU et VM * **Un tap n'existe jamais sans ses règles** : la chaîne ``pre-tap`` est posée avant la création du tap et retirée après sa suppression. Dans l'autre ordre, une VM pourrait émettre sans filtre entre deux étapes. +* **La MAC d'une interface est figée sur son tap** (entrée de pont ``static sticky``), posée avant + que le tap soit monté. ``static`` seul ne suffit pas : l'apprentissage déplace une entrée + ``static``, pas une entrée ``sticky`` (mesuré, #95). * L'arrêt d'une VM ne touche **jamais** aux fichiers disque. En revanche, un ``quit`` brutal est envoyé à l'expiration de ``times.timeout_vms_stop``. ``system_powerdown`` est renvoyé toutes les ``times.next_vms_shutdown`` : un appui ACPI arrivé avant que l'invité sache le traiter est perdu. diff --git a/docs/concepts/vpc-subnet-vm.rst b/docs/concepts/vpc-subnet-vm.rst index 21ad46e..99fcb28 100644 --- a/docs/concepts/vpc-subnet-vm.rst +++ b/docs/concepts/vpc-subnet-vm.rst @@ -147,6 +147,15 @@ depuis ces adresses. L'IPv6 n'est pas filtrée (#61). Les règles sont retirées du tap ; le watchdog signale une interface d'une VM ``running`` dont les règles manquent ou ont été modifiées. +**MAC figée sur le tap.** Le pont du subnet, dans le netns du VPC, apprend sur quel port se trouve +chaque MAC. Pendant une migration, l'ancienne VM et la nouvelle portent la même MAC sur deux hôtes : +une trame de l'ancienne, arrivée par le VXLAN, suffisait à déplacer la MAC de la nouvelle vers +``v--i``, et le trafic destiné à la VM locale repartait vers l'ancien hôte jusqu'à ce +qu'elle émette à nouveau (#95). L'agent pose donc, à la création du tap, une entrée de pont +``static sticky`` de la MAC de l'interface sur son tap : l'apprentissage ne peut plus la déplacer +(une entrée ``static`` seule le peut). Elle disparaît avec le tap ; le watchdog signale une +interface d'une VM ``running`` dont l'entrée manque. + **Serveur DHCP.** ``dhcp_server: true`` sur une interface lève le seul blocage des réponses DHCP, pour cette interface. Cas d'usage : une VM d'un subnet ``bridge`` qui sert le DHCP et le PXE de machines diskless du segment physique, avec des réservations statiques. Les autres contrôles diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index ae90aef..738ad14 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -377,9 +377,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - hv1 - #50 * - ``35-filtrage-port`` - - filtrage au port — en sortie vers le fabric (v--i) : ARP vers la gateway et l'adresse d'émission, DHCP émis depuis ces adresses, MAC anycast confinée dans les deux sens ; à la sortie de chaque VM (pre-tap) : MAC, IP et ARP usurpés, faux serveur DHCP, source 0.0.0.0 hors DHCP, type de trame non IP, NIC autorisée en serveur DHCP (dhcp_server), règles surveillées par le watchdog et retirées avec la VM + - filtrage au port — en sortie vers le fabric (v--i) : ARP vers la gateway et l'adresse d'émission, DHCP émis depuis ces adresses, MAC anycast confinée dans les deux sens ; à la sortie de chaque VM (pre-tap) : MAC, IP et ARP usurpés, faux serveur DHCP, source 0.0.0.0 hors DHCP, type de trame non IP, NIC autorisée en serveur DHCP (dhcp_server), règles surveillées par le watchdog et retirées avec la VM, MAC de chaque VM figée sur son tap (fdb static sticky) et surveillée par le watchdog - hv1 - - #57, #76 + - #57, #76, #95 * - ``41-evpn-l2`` - subnet vxlan étendu entre deux hôtes par EVPN — VTEP local, VTEP distant et inondation appris, MAC des VM en type 2, trafic ICMP et TCP, MTU 1500 de bout en bout - hv1 hv2 @@ -417,9 +417,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - hv1 hv2 - #41, #81 * - ``52-migration`` - - migration d'une adresse de VM entre hôtes d'un VPC routé — /32 retiré en premier, /24 en filet puis en ECMP, séquence orchestrée, 40 sources, suppression du subnet refusée tant qu'une VM l'utilise, MAC anycast hors EVPN + - migration d'une adresse de VM entre hôtes d'un VPC routé — /32 retiré en premier, /24 en filet puis en ECMP, séquence orchestrée, 40 sources, suppression du subnet refusée tant qu'une VM l'utilise, MAC anycast hors EVPN, MAC de la VM migrée figée sur son tap pendant la séquence orchestrée - hv1 hv2 hv3 - - #41, #57 + - #41, #57, #95 * - ``53-watchdog-l3`` - watchdog d'un VPC routé — /32 orphelin signalé comme trou noir, /32 manquant signalé, unreachable default absente signalée, aucune fausse alerte BGP ni L3VNI, trafic intact après les essais - hv1 hv3 diff --git a/docs/exploitation/diagnostic.rst b/docs/exploitation/diagnostic.rst index 08a79db..74838b1 100644 --- a/docs/exploitation/diagnostic.rst +++ b/docs/exploitation/diagnostic.rst @@ -116,6 +116,16 @@ Retrouver la chaîne d'une interface par sa MAC, puis lire ses règles : Une chaîne absente, ou une interface absente de ``pre_ports``, laisse la VM émettre sans filtre : le watchdog le signale (``interface : nftables rule missing``). Recréer la VM repose ses règles. +La MAC de chaque interface est figée sur son tap par une entrée de pont ``static sticky`` +(:doc:`/concepts/vpc-subnet-vm`). Sans elle, après une migration, la VM peut rester injoignable +quelques secondes : sa MAC a été réapprise vers ``v--i``. Le watchdog le signale +(``interface : mac not pinned on tap``). Lire l'entrée, et la reposer à la main : + +.. code-block:: bash + + ip netns exec bridge fdb show dev tap + ip netns exec bridge fdb replace dev tap master static sticky + La VM a une adresse mais cloud-init n'applique rien --------------------------------------------------- diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index e2a5593..632845b 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -167,6 +167,15 @@ processus s'arrêtait. Jamais observé en lab. La socket est désormais créée dans le netns du VPC, et `metadata@.service` est relancé en cas d'échec (`Restart=on-failure`) +- **La MAC d'une VM reste sur son tap pendant une migration (#95).** Pendant la séquence + orchestrée d'une migration, la même MAC existe sur l'ancien et le nouvel hôte. Une trame de + l'ancienne VM, arrivée par le VXLAN du subnet, faisait réapprendre sa MAC par le pont du netns + du nouvel hôte vers le VXLAN : le trafic destiné à la nouvelle VM repartait vers l'ancien hôte, + environ 10 s, jusqu'à ce qu'elle émette à nouveau (mesuré en lab ; test 52 intermittent). + L'agent pose désormais, à la création du tap, une entrée de pont `static sticky` de la MAC de + l'interface sur son tap, que l'apprentissage ne peut pas déplacer. Tous les modes de subnet. + Le watchdog signale une interface d'une VM `running` dont l'entrée manque + ## Mise à jour depuis la 0.2.0 - **Les règles de pont passent d'ebtables à nftables (#76)** : l'agent appelle `nft` et pose ses @@ -203,6 +212,9 @@ - **`br-public` du netns (#42) : seuls les VPC créés par la 0.3.0 sont protégés.** L'agent ne reprend pas les VPC existants au démarrage : recréer chaque VPC pour fermer l'entrée par le segment public +- **MAC figée sur le tap (#95) : seules les VM créées par la 0.3.0 l'ont.** L'agent ne reprend + pas les VM existantes au démarrage, et le watchdog les signale à chaque tick jusqu'à leur + recréation. Le vidage de l'hyperviseur demandé par #76 les recrée de toute façon - **`name` est obligatoire sur chaque interface de `POST /vms` (#88)** : un appel qui l'omet reçoit un 400. Au démarrage, l'agent nomme `nic-` (`nic-0`, `nic-1`…) les interfaces des VM existantes