diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index 8296ed4..7574ab2 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -298,9 +298,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - hv1 - #41, #57, #33, #62, #74, #81 * - ``12-etats`` - - machine d'états — 409 pendant creating, suppression depuis error, dépendances VM → subnet → VPC, recréation sous le même nom + - machine d'états — 409 pendant creating, suppression depuis error, sockets QEMU d'une VM en error retirés, dépendances VM → subnet → VPC, recréation sous le même nom - hv1 - - #41 + - #41, #84 * - ``21-dhcp-two`` - DHCP par le serveur intégré (backend two) — bail, server-id, renouvellement, option 121, un serveur par subnet, démarrages simultanés - hv1 diff --git a/docs/exploitation/services.rst b/docs/exploitation/services.rst index d6ff8f7..1ae0b15 100644 --- a/docs/exploitation/services.rst +++ b/docs/exploitation/services.rst @@ -117,6 +117,10 @@ Sockets par VM /run/two/vms/monitor/.sock monitor QEMU /run/two/vms/qmp/.sock QMP (utilisé par l'agent) +QEMU les crée au démarrage et les retire en quittant normalement. La suppression d'une VM les +retire aussi, une fois QEMU arrêté : un QEMU qui échoue au démarrage (disque absent) peut les +laisser derrière lui. + .. code-block:: bash socat -,raw,echo=0 UNIX-CONNECT:/run/two/vms/serial/i-web.sock diff --git a/internal/vm/delete.go b/internal/vm/delete.go index 304a75d..06d3658 100644 --- a/internal/vm/delete.go +++ b/internal/vm/delete.go @@ -1,7 +1,9 @@ package vm import ( + "errors" "fmt" + "io/fs" "os" "path/filepath" "time" @@ -57,6 +59,10 @@ func StopVM(db *badger.DB, name string, cfg *configuration.Config) error { } // socket absent ou QEMU déjà arrêté : cleanup direct + if err := removeQEMUSockets(cfg, name); err != nil { + return err + } + if err := netns.Call(nic.vpcName, func() error { for _, n := range d.nics { if err := iptables.DeleteMetadataRedirect(n.ip, nic.interfaceIP, d.metadataPort); err != nil { @@ -90,6 +96,16 @@ func StopVM(db *badger.DB, name string, cfg *configuration.Config) error { return state.Set(db, "vm/"+name, state.Deleted) } +func removeQEMUSockets(cfg *configuration.Config, name string) error { + for _, dir := range []string{cfg.QEMU.SerialDir, cfg.QEMU.MonitorDir, cfg.QEMU.QMPDir} { + path := filepath.Join(dir, name+".sock") + if err := os.Remove(path); err != nil && !errors.Is(err, fs.ErrNotExist) { + return fmt.Errorf("remove qemu socket: %w", err) + } + } + return nil +} + func removeDHCPFiles(d vmData, name string, backend dhcpbackend.Backend) error { for _, f := range dhcpReservations(d) { if err := backend.DelVM(f.subnet, name, f.reservations); err != nil { diff --git a/internal/vm/delete_test.go b/internal/vm/delete_test.go new file mode 100644 index 0000000..d296f68 --- /dev/null +++ b/internal/vm/delete_test.go @@ -0,0 +1,86 @@ +package vm + +import ( + "os" + "path/filepath" + "strings" + "testing" + + configuration "git.g3e.fr/syonad/two/internal/config/agent" +) + +func socketDirs(t *testing.T) *configuration.Config { + t.Helper() + root, err := os.MkdirTemp("", "sock") + if err != nil { + t.Fatal(err) + } + t.Cleanup(func() { os.RemoveAll(root) }) + cfg := &configuration.Config{} + cfg.QEMU.SerialDir = filepath.Join(root, "serial") + cfg.QEMU.MonitorDir = filepath.Join(root, "monitor") + cfg.QEMU.QMPDir = filepath.Join(root, "qmp") + for _, dir := range []string{cfg.QEMU.SerialDir, cfg.QEMU.MonitorDir, cfg.QEMU.QMPDir} { + if err := os.Mkdir(dir, 0755); err != nil { + t.Fatal(err) + } + } + return cfg +} + +func leave(t *testing.T, path string) { + t.Helper() + if err := os.WriteFile(path, nil, 0600); err != nil { + t.Fatal(err) + } +} + +func TestRemoveQEMUSockets_RemovesTheThreeSocketsOfTheVM(t *testing.T) { + cfg := socketDirs(t) + sockets := []string{ + filepath.Join(cfg.QEMU.SerialDir, "t12-err.sock"), + filepath.Join(cfg.QEMU.MonitorDir, "t12-err.sock"), + filepath.Join(cfg.QEMU.QMPDir, "t12-err.sock"), + } + for _, s := range sockets { + leave(t, s) + } + other := filepath.Join(cfg.QEMU.MonitorDir, "t12-ok.sock") + leave(t, other) + + if err := removeQEMUSockets(cfg, "t12-err"); err != nil { + t.Fatal(err) + } + for _, s := range sockets { + if _, err := os.Lstat(s); !os.IsNotExist(err) { + t.Errorf("%s laissé (%v)", s, err) + } + } + if _, err := os.Lstat(other); err != nil { + t.Errorf("socket d'une autre VM retiré : %v", err) + } +} + +func TestRemoveQEMUSockets_AbsentSocketsAreNotAnError(t *testing.T) { + cfg := socketDirs(t) + leave(t, filepath.Join(cfg.QEMU.MonitorDir, "t12-err.sock")) + if err := removeQEMUSockets(cfg, "t12-err"); err != nil { + t.Errorf("sockets serial et qmp absents : %v", err) + } + if err := removeQEMUSockets(cfg, "t12-err"); err != nil { + t.Errorf("second passage : %v", err) + } +} + +func TestRemoveQEMUSockets_ReportsAFailedRemoval(t *testing.T) { + cfg := socketDirs(t) + blocked := filepath.Join(cfg.QEMU.QMPDir, "t12-err.sock") + if err := os.Mkdir(blocked, 0755); err != nil { + t.Fatal(err) + } + leave(t, filepath.Join(blocked, "x")) + err := removeQEMUSockets(cfg, "t12-err") + if err == nil || !strings.Contains(err.Error(), "remove qemu socket") || !strings.Contains(err.Error(), blocked) { + t.Errorf("erreur %v, attendu l'échec de suppression de %s", err, blocked) + } +} diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index baca9d6..ad63707 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -12,6 +12,10 @@ - **`default_route: true` sans `gateway` est réservé au mode `bridge` (#81)** : refusé (400) en `vxlan` et en `public_ip`. Hors `bridge`, la gateway lue dans la table de routage de l'hôte n'est pas sur le subnet des VM : la route par défaut annoncée était inutilisable +- **La suppression d'une VM retire ses sockets QEMU (#84).** Quand QEMU échouait au démarrage + (disque absent par exemple), il pouvait laisser `.sock` dans `serial_dir`, `monitor_dir` ou + `qmp_dir`, que la suppression de la VM ne retirait pas. Les trois sont désormais supprimés une + fois QEMU arrêté ; un fichier absent n'est pas une erreur ## Mise à jour depuis la 0.2.0 diff --git a/test/e2e/suite/12-etats.sh b/test/e2e/suite/12-etats.sh index aab8d3e..5edf9f3 100644 --- a/test/e2e/suite/12-etats.sh +++ b/test/e2e/suite/12-etats.sh @@ -1,6 +1,6 @@ -# fonctionnalité: machine d'états — 409 pendant creating, suppression depuis error, dépendances VM → subnet → VPC, recréation sous le même nom +# fonctionnalité: machine d'états — 409 pendant creating, suppression depuis error, sockets QEMU d'une VM en error retirés, dépendances VM → subnet → VPC, recréation sous le même nom # hôtes: hv1 -# tickets: #41 +# tickets: #41, #84 on hv1 <<'NODE' check "VPC vp-t12a" vpc_create vp-t12a 10.12.0.0/16 @@ -23,8 +23,11 @@ check "suppression d'un VPC inconnu, 404" expect_code 404 api_code DELETE vpcs/v check "VM t12-err sur un disque absent : acceptée, 202 (pas de refus synchrone)" expect_code 202 api_post_code vms "$(vm_body t12-err sn-t12a 10.12.1.11 "${VOLUMES}/t12-absent.qcow2")" check "t12-err passe en error" wait_state vms/t12-err error +info "t12-err : sockets laissés par QEMU : $(ls /run/two/vms/serial/t12-err.sock /run/two/vms/monitor/t12-err.sock /run/two/vms/qmp/t12-err.sock 2>&1 | tr '\n' ' ')" +check "t12-err : les trois sockets QEMU posés à la main s'ils manquent" sh -c 'for d in serial monitor qmp; do [ -e "/run/two/vms/${d}/t12-err.sock" ] || : > "/run/two/vms/${d}/t12-err.sock" || exit 1; done' check "suppression de t12-err depuis error, 202" expect_code 202 api_code DELETE vms/t12-err check "t12-err supprimée" wait_state vms/t12-err deleted +check "t12-err : aucun socket QEMU laissé dans /run/two/vms" sh -c 'for d in serial monitor qmp; do [ ! -e "/run/two/vms/${d}/t12-err.sock" ] || { echo "/run/two/vms/${d}/t12-err.sock laissé"; exit 1; }; done' check "t12-err : aucune unité two-vm-t12-err" sh -c '! systemctl list-units --all --plain --no-legend "two-vm-t12-err*" | grep -q .' check "suppression de t12-a" vm_delete t12-a