Pakete: Neustart beim Update, Stopp beim Entfernen, Plugin räumt seine Dateien weg #62

Merged
jochen merged 2 commits from fix/package-lifecycle into master 2026-11-13 10:50:21 +00:00
Collaborator

Fixes #44. Baut auf master nach #61 auf.

Grundlage

pkg-script(5): Bei einem Upgrade laufen das neue pre-install, das alte pre-deinstall, dann der Austausch der Dateien und das neue post-install. Dabei ist PKG_UPGRADE gesetzt. Das alte post-deinstall läuft beim Upgrade nicht.

Änderung

mdns-bridged (packaging/freebsd/MANIFEST.in)

  • post-install: Läuft der Daemon, wird er neu gestartet – vorher prüft die neue Version mit --check-config die Config, die rc.conf nennt.
    • Prüfung ok: service mdns_bridged onerestart, Meldung restarted with the new version.
    • Prüfung schlägt fehl: Der alte Daemon läuft weiter, die Upgrade-Ausgabe nennt den Grund. Sonst stünde nach einem Update, das die Config strenger prüft (#61), die Bridge.
    • Nicht bei Installation in ein anderes Root (PKG_ROOTDIR).
  • pre-deinstall: Beim Entfernen, nicht beim Upgrade, wird ein laufender Daemon gestoppt.

os-mdns-bridge (opnsense/build-plugin.sh)

  • pre-deinstall: stoppt den Daemon. Das Daemon-Paket geht nicht immer mit, etwa wenn es von Hand installiert wurde.
  • post-deinstall: entfernt, was die Templates erzeugt haben: /usr/local/etc/mdns-bridge.toml, /etc/rc.conf.d/mdns_bridged und das Verzeichnis /usr/local/etc/mdns-bridge/ mit dem PSK.

Der Neustart läuft bewusst über service und nicht über configctl. Ein Firmware-Update kann selbst unter configd laufen, und die Config-Prüfung ist das, was die Plugin-Aktion zusätzlich täte.

Das erste Update von 0.1.1 startet schon neu: Das erledigt das post-install der neuen Version. Das fehlende pre-deinstall von 0.1.1 spielt beim Upgrade keine Rolle.

Getestet

  • sh -n für alle sechs Skriptblöcke beider Manifeste.
  • Die Logik mit Attrappen für service, sysrc und den Daemon:
Fall Ergebnis
Upgrade, Daemon läuft, Config ok Prüfung, dann onerestart
Upgrade, Daemon läuft, Config abgelehnt nur Prüfung, kein Neustart, Grund in der Ausgabe
Upgrade, Daemon läuft nicht nichts
Installation in anderes Root nichts
Entfernen, Daemon läuft (Daemon- und Plugin-Paket) onestop
pre-deinstall beim Upgrade nichts
Plugin post-deinstall beim Entfernen Config, rc.conf.d-Eintrag und PSK-Verzeichnis weg
Plugin post-deinstall mit PKG_UPGRADE alles bleibt

Nicht getestet: ein echtes pkg upgrade bzw. pkg remove auf FreeBSD oder OPNsense. Insbesondere offen:

  • dass PKG_UPGRADE in den Skripten ankommt, wie pkg-script(5) es beschreibt;
  • dass service … onerestart aus dem post-install eines Firmware-Updates heraus sauber durchläuft.

Bitte beim ersten Update auf einer Firewall auf die Zeile mdns-bridged: restarted with the new version. achten und danach im Report uptime_secs.

Nicht enthalten

#49 (rc.configure_plugins statt der Cache-Dateien) – eigener Punkt.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Fixes #44. Baut auf master nach #61 auf. ## Grundlage pkg-script(5): Bei einem Upgrade laufen das **neue** `pre-install`, das **alte** `pre-deinstall`, dann der Austausch der Dateien und das **neue** `post-install`. Dabei ist `PKG_UPGRADE` gesetzt. Das alte `post-deinstall` läuft beim Upgrade nicht. ## Änderung **`mdns-bridged`** (`packaging/freebsd/MANIFEST.in`) - `post-install`: Läuft der Daemon, wird er neu gestartet – vorher prüft die neue Version mit `--check-config` die Config, die rc.conf nennt. - Prüfung ok: `service mdns_bridged onerestart`, Meldung `restarted with the new version`. - Prüfung schlägt fehl: Der alte Daemon läuft weiter, die Upgrade-Ausgabe nennt den Grund. Sonst stünde nach einem Update, das die Config strenger prüft (#61), die Bridge. - Nicht bei Installation in ein anderes Root (`PKG_ROOTDIR`). - `pre-deinstall`: Beim Entfernen, nicht beim Upgrade, wird ein laufender Daemon gestoppt. **`os-mdns-bridge`** (`opnsense/build-plugin.sh`) - `pre-deinstall`: stoppt den Daemon. Das Daemon-Paket geht nicht immer mit, etwa wenn es von Hand installiert wurde. - `post-deinstall`: entfernt, was die Templates erzeugt haben: `/usr/local/etc/mdns-bridge.toml`, `/etc/rc.conf.d/mdns_bridged` und das Verzeichnis `/usr/local/etc/mdns-bridge/` mit dem PSK. Der Neustart läuft bewusst über `service` und nicht über `configctl`. Ein Firmware-Update kann selbst unter configd laufen, und die Config-Prüfung ist das, was die Plugin-Aktion zusätzlich täte. **Das erste Update von 0.1.1 startet schon neu:** Das erledigt das `post-install` der neuen Version. Das fehlende `pre-deinstall` von 0.1.1 spielt beim Upgrade keine Rolle. ## Getestet - `sh -n` für alle sechs Skriptblöcke beider Manifeste. - Die Logik mit Attrappen für `service`, `sysrc` und den Daemon: | Fall | Ergebnis | |---|---| | Upgrade, Daemon läuft, Config ok | Prüfung, dann `onerestart` | | Upgrade, Daemon läuft, Config abgelehnt | nur Prüfung, kein Neustart, Grund in der Ausgabe | | Upgrade, Daemon läuft nicht | nichts | | Installation in anderes Root | nichts | | Entfernen, Daemon läuft (Daemon- und Plugin-Paket) | `onestop` | | `pre-deinstall` beim Upgrade | nichts | | Plugin `post-deinstall` beim Entfernen | Config, rc.conf.d-Eintrag und PSK-Verzeichnis weg | | Plugin `post-deinstall` mit `PKG_UPGRADE` | alles bleibt | **Nicht getestet:** ein echtes `pkg upgrade` bzw. `pkg remove` auf FreeBSD oder OPNsense. Insbesondere offen: - dass `PKG_UPGRADE` in den Skripten ankommt, wie pkg-script(5) es beschreibt; - dass `service … onerestart` aus dem `post-install` eines Firmware-Updates heraus sauber durchläuft. Bitte beim ersten Update auf einer Firewall auf die Zeile `mdns-bridged: restarted with the new version.` achten und danach im Report `uptime_secs`. ## Nicht enthalten #49 (`rc.configure_plugins` statt der Cache-Dateien) – eigener Punkt. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Packages: restart on upgrade, stop on removal, plugin removes its files
Some checks failed
ci / rust (push) Has been cancelled
00f85762dd
pkg runs, on an upgrade: new pre-install, old pre-deinstall, file
replacement, new post-install, with PKG_UPGRADE set (pkg-script(5)).

mdns-bridged:
- post-install restarts a running daemon, so a fix takes effect right
  away instead of at the next Apply or reboot - but only if the new
  version accepts the config (--check-config). If it does not, the old
  daemon is left running and the reason printed. Not when installing
  into another root.
- pre-deinstall stops a running daemon when the package is removed
  (not on an upgrade). Up to now binary and rc script went away and the
  process kept running, out of reach of `service`.

os-mdns-bridge:
- pre-deinstall stops the daemon (the daemon package is not always
  removed along with the plugin).
- post-deinstall removes what the templates generated: the config, the
  rc.conf.d entry and the directory with the PSK.

The first upgrade from 0.1.1 already restarts: it is the new
post-install that does it.

Fixes the package part of #44.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
README: updates and removal of the packages
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 3m2s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 4m25s
ci / rust (pull_request) Successful in 3m29s
aaaac29053
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-13 10:50:13 +00:00
jochen merged commit 7c24a38d2c into master 2026-11-13 10:50:21 +00:00
jochen deleted branch fix/package-lifecycle 2026-11-13 10:50:21 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
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
jochen/mdns-bridge!62
No description provided.