From 497f13f1f4440ed67bc0dcfbaa1d017bdb3d99c9 Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Mon, 26 Oct 2026 23:47:48 +0100 Subject: [PATCH] =?UTF-8?q?f-92:=20doc:=20netns.Call,=20socket=20des=20m?= =?UTF-8?q?=C3=A9tadonn=C3=A9es,=20notes=200.3.0=20#92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- docs/architecture/contraintes.rst | 7 +++++++ docs/architecture/vue-densemble.rst | 2 +- docs/exploitation/services.rst | 2 +- release_notes/0.3.0.md | 5 +++++ 4 files changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/architecture/contraintes.rst b/docs/architecture/contraintes.rst index ac204dc..f52c219 100644 --- a/docs/architecture/contraintes.rst +++ b/docs/architecture/contraintes.rst @@ -37,6 +37,13 @@ Réseau gateway de l'hôte n'est pas sur le subnet, la route par défaut serait inutilisable, et jointe elle contournerait le netns et la VRF. * ``169.254.169.254`` est centralisé dans ``metadata.ServiceIP`` — ne pas le réécrire en dur. +* **Tout travail dans un netns passe par ``netns.Call``.** ``setns`` ne change que le thread + courant : ``netns.Call`` verrouille la goroutine sur son thread, revient ensuite au netns de ce + thread (``/proc/thread-self``, jamais ``/proc/self``, qui désigne le thread principal) et + détruit un thread qui ne peut pas y revenir (#91). +* **Une socket appartient au netns du thread qui la crée** : un listener destiné à un VPC est + créé dans ``netns.Call``, puis servi hors du netns. Après un ``setns`` suivi d'un + déverrouillage du thread, rien ne garantit que la socket soit créée sur le bon thread (#92). QEMU et VM ---------- diff --git a/docs/architecture/vue-densemble.rst b/docs/architecture/vue-densemble.rst index 34895a4..1c06d4c 100644 --- a/docs/architecture/vue-densemble.rst +++ b/docs/architecture/vue-densemble.rst @@ -47,7 +47,7 @@ Paquets * - ``internal/sysctl`` - écriture sous ``/proc/sys``, dans un netns si besoin * - ``internal/netns`` - - network namespaces : create/enter/delete/call + - network namespaces : create/delete/call * - ``internal/netif`` - netlink : bridge, veth, vxlan, tap, routes, adresses * - ``internal/nft``, ``internal/iptables`` diff --git a/docs/exploitation/services.rst b/docs/exploitation/services.rst index 96fb28e..55892ae 100644 --- a/docs/exploitation/services.rst +++ b/docs/exploitation/services.rst @@ -23,7 +23,7 @@ s'excluent : celle qui tourne dépend de ``dhcp.backend`` (voir :doc:`configurat - serveur DHCP intégré, un par subnet — backend ``two`` * - ``metadata@.service`` - ```` - - serveur de metadata cloud-init, un par VM + - serveur de metadata cloud-init, un par VM, relancé en cas d'échec * - ``two-hostsvc.service`` - — - relais DNS et NTP des VM, un par hyperviseur, démarré avant l'agent (voir diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index 3dac3ea..41743d7 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -87,6 +87,11 @@ `delete vxlan: Link not found` et le watchdog a signalé `br-000000` et des VRF absents. L'agent revient désormais au netns du thread courant, et un thread qui ne peut pas y revenir est détruit au lieu d'être réutilisé. La création d'un netns est corrigée de la même façon +- **Le serveur de métadonnées crée sa socket dans le netns du VPC (#92).** Il faisait entrer un + seul thread dans le VPC, puis créait sa socket sur le thread où il s'exécutait à cet instant : + sur un autre thread, la socket était créée dans le netns de l'hôte, l'écoute échouait et le + 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`) ## Mise à jour depuis la 0.2.0