docs(priv_proto): update ReloadGatewayNginx comment — state-aware dispatch

The implementation now queries ActiveState and dispatches reload/
reset-start/start rather than blindly calling systemd-run nginx -s reload.
Clarify that machine-bus transport requires root.
This commit is contained in:
atlas 2026-06-04 09:53:05 +02:00
commit c7ea495bf9

View file

@ -182,8 +182,13 @@ pub enum PrivRequest {
/// Run `systemctl daemon-reload`.
DaemonReload,
/// Reload nginx inside the `hive-gateway` container via
/// `systemd-run --machine=hive-gateway nginx -s reload`.
/// Synchronise the nginx unit inside the `hive-gateway` container.
/// hive-priv queries `ActiveState` and dispatches:
/// - `active` → `systemctl reload nginx` (SIGHUP, zero-downtime)
/// - `failed` → `systemctl reset-failed nginx` + `systemctl start nginx`
/// - otherwise → `systemctl start nginx`
/// Requires root: `--machine=hive-gateway` enters the container
/// namespace via the machine bus (forbidden for unprivileged users).
ReloadGatewayNginx,
// --- Socket dir ownership ---