f-92: doc: netns.Call, socket des métadonnées, notes 0.3.0 #92

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-26 23:47:48 +01:00
commit 497f13f1f4
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
4 changed files with 14 additions and 2 deletions

View file

@ -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
----------

View file

@ -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``

View file

@ -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``
- ``<nom de la VM>``
- 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

View file

@ -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