Serveur DHCP intégré : socket de contrôle laissée après l'arrêt, pas d'arrêt propre sur SIGTERM #77

Closed
opened 2026-10-17 20:29:12 +00:00 by nicolas.boufideline · 2 comments

Constat

Campagne du 2026-10-17 (#70) : après la suppression d'un subnet en backend two, /run/two/dhcp/<vpc>_br-<id>.sock reste en place alors que l'unité dhcp@ est arrêtée (« Deactivated successfully »). Relevé par 62-nettoyage-global dans les deux passes, et vu à la main sur hv1.

Cause

  • internal/api/dhcp/server.go crée la socket ; en Go, fermer l'écouteur Unix supprime le fichier, et cmd/dhcp/main.go ne prévoit cette fermeture (defer control.Close()) qu'à la sortie normale.
  • cmd/dhcp ne gère pas les signaux : à l'arrêt, systemd envoie SIGTERM, le processus meurt sans exécuter ses defer, et la socket reste.
  • TeardownSubnet (internal/dhcpbackend/two.go) supprime le fichier d'état mais pas la socket.

Impact faible (Listen supprime une socket périmée au démarrage suivant), mais c'est un reste dans /run/two et le signe d'un arrêt brutal du serveur.

Décision (2026-10-17) : les deux corrections

  1. Arrêt propre de cmd/dhcp : intercepter SIGTERM et SIGINT, fermer la socket de contrôle et la socket UDP, puis sortir normalement. Même principe que l'arrêt gracieux de l'agent (2026-08-18).
  2. TeardownSubnet supprime aussi la socket, comme le fichier d'état, pour couvrir les morts brutales (SIGKILL, plantage).

Tests unitaires pour les deux.

Critère de clôture

62-nettoyage-global vert en lab (aucun socket de contrôle DHCP résiduel) ; assert_clean sans exclusion des sockets DHCP : retirer l'exclusion ! -path '/run/two/dhcp/*.sock' de host_state (test/e2e/lib/fixture.sh), ajoutée en attendant ce correctif.

## Constat Campagne du 2026-10-17 (#70) : après la suppression d'un subnet en backend `two`, `/run/two/dhcp/<vpc>_br-<id>.sock` reste en place alors que l'unité `dhcp@` est arrêtée (« Deactivated successfully »). Relevé par `62-nettoyage-global` dans les deux passes, et vu à la main sur hv1. ## Cause - `internal/api/dhcp/server.go` crée la socket ; en Go, fermer l'écouteur Unix supprime le fichier, et `cmd/dhcp/main.go` ne prévoit cette fermeture (`defer control.Close()`) qu'à la sortie normale. - `cmd/dhcp` **ne gère pas les signaux** : à l'arrêt, systemd envoie `SIGTERM`, le processus meurt sans exécuter ses `defer`, et la socket reste. - `TeardownSubnet` (`internal/dhcpbackend/two.go`) supprime le fichier d'état mais pas la socket. Impact faible (`Listen` supprime une socket périmée au démarrage suivant), mais c'est un reste dans `/run/two` et le signe d'un arrêt brutal du serveur. ## Décision (2026-10-17) : les deux corrections 1. **Arrêt propre de `cmd/dhcp`** : intercepter `SIGTERM` et `SIGINT`, fermer la socket de contrôle et la socket UDP, puis sortir normalement. Même principe que l'arrêt gracieux de l'agent (2026-08-18). 2. **`TeardownSubnet` supprime aussi la socket**, comme le fichier d'état, pour couvrir les morts brutales (`SIGKILL`, plantage). Tests unitaires pour les deux. ## Critère de clôture `62-nettoyage-global` vert en lab (aucun socket de contrôle DHCP résiduel) ; `assert_clean` sans exclusion des sockets DHCP : retirer l'exclusion `! -path '/run/two/dhcp/*.sock'` de `host_state` (`test/e2e/lib/fixture.sh`), ajoutée en attendant ce correctif.
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/62-nettoyage-global.sh ${HOST} : aucun socket de contrôle DHCP known

À retirer avec ce correctif : remplacer le marqueur (known "#77" ou known_flaky "#77", 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.

À retirer aussi : l'exclusion ! -path '/run/two/dhcp/*.sock' de host_state (test/e2e/lib/fixture.sh), pour que assert_clean vérifie de nouveau les sockets après chaque test.

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/62-nettoyage-global.sh` | ${HOST} : aucun socket de contrôle DHCP | `known` | **À retirer avec ce correctif** : remplacer le marqueur (`known "#77"` ou `known_flaky "#77"`, 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. À retirer aussi : l'exclusion `! -path '/run/two/dhcp/*.sock'` de `host_state` (`test/e2e/lib/fixture.sh`), pour que `assert_clean` vérifie de nouveau les sockets après chaque test. `run.sh --connus` compte les contrôles connus comme des échecs, pour voir l'état brut.
Author
Owner

Bilan de clôture

Correctif (ecaa34d, fusionné dans main par ccd1213) :

  • cmd/dhcp intercepte SIGTERM et SIGINT (signal.NotifyContext), ferme la socket de contrôle (le fichier disparaît) puis la socket UDP, et sort à 0 ; une perte de la socket UDP non demandée reste une erreur ;
  • Two.TeardownSubnet supprime aussi la socket avec le fichier d'état (removeFiles), pour une mort brutale (SIGKILL, plantage).

Vérifications : 4 tests unitaires, 3 mutants tués ; binaire réel sur macOS (SIGTERM et SIGINT → code 0, socket retirée ; binaire précédent → code 143, socket laissée).

Lab du 2026-10-19 (evpn-3hv, binaires de feature-62) : 62-nettoyage-global 54/54, dont « aucun socket de contrôle DHCP » sur hv1, hv2, hv3 ; assert_clean vérifie désormais les sockets DHCP après chaque test (exclusion retirée de host_state) et n'a relevé aucune socket DHCP résiduelle sur toute la suite. Marqueur known "#77" remplacé par check.

## Bilan de clôture **Correctif** (`ecaa34d`, fusionné dans main par `ccd1213`) : - `cmd/dhcp` intercepte `SIGTERM` et `SIGINT` (`signal.NotifyContext`), ferme la socket de contrôle (le fichier disparaît) puis la socket UDP, et sort à 0 ; une perte de la socket UDP non demandée reste une erreur ; - `Two.TeardownSubnet` supprime aussi la socket avec le fichier d'état (`removeFiles`), pour une mort brutale (`SIGKILL`, plantage). **Vérifications** : 4 tests unitaires, 3 mutants tués ; binaire réel sur macOS (SIGTERM et SIGINT → code 0, socket retirée ; binaire précédent → code 143, socket laissée). **Lab du 2026-10-19** (evpn-3hv, binaires de `feature-62`) : `62-nettoyage-global` 54/54, dont « aucun socket de contrôle DHCP » sur hv1, hv2, hv3 ; `assert_clean` vérifie désormais les sockets DHCP après chaque test (exclusion retirée de `host_state`) et n'a relevé aucune socket DHCP résiduelle sur toute la suite. Marqueur `known "#77"` remplacé par `check`.
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#77
No description provided.