docs(PROJ-67,PROJ-68): Deployment-Status auf Deployed setzen

Manticore-Upgrade (PROJ-67) und sudo-Provisionierung (PROJ-68) auf 131
und 132 verifiziert abgeschlossen; QA/Deployment-Notizen ergänzt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sysops
2026-07-06 11:47:33 +02:00
co-authored by Claude Sonnet 5
parent 4eba165250
commit 8bd02facf5
4 changed files with 1083 additions and 16 deletions
@@ -1,7 +1,7 @@
---
id: PROJ-68
title: sudo-Provisionierung für Admin-Dienststeuerung fehlte komplett
status: In Progress
status: Deployed (Produktiv 131, 2026-07-05)
created: 2026-07-05
---
@@ -62,11 +62,12 @@ Teil des `firewall-security`-Skills und bewusst außerhalb dieses Tickets
die Datei schon existiert/aktuell ist), damit auch 132 (und jede
andere Bestandsinstallation) beim nächsten Deploy automatisch
nachgerüstet wird — analog zum PROJ-67-Upgrade-Pfad-Muster.
- [ ] Nach der Provisionierung: Start/Stop/Restart über
- [x] Nach der Provisionierung: Start/Stop/Restart über
`POST /api/admin/services/{name}` funktioniert für alle Dienste in
der Whitelist, verifiziert auf 132.
**NICHT erfüllt** — durch systemd-CapabilityBoundingSet blockiert, sudo
fehlen CAP_SETUID/CAP_SETGID. Siehe QA Test Results (BLOCKER).
**ERFÜLLT (Re-QA 2026-07-05)**Bounding-Set um CAP_SETUID/CAP_SETGID
erweitert; sudo-Restart im Unit-Kontext erfolgreich (manticore +
archivmail-web, PID-Wechsel verifiziert). Siehe Re-QA Test Results.
- [ ] `archivmail-nft`-Fehlen ist dokumentiert (nicht Teil dieses Tickets,
siehe Non-Goals), damit es nicht als überraschender Folgefehler
auftaucht.
@@ -211,5 +212,105 @@ Self-Update-Timing-Effekts, siehe PROJ-67).
Re-QA auf 132 steht noch aus (echter API-Call nach Deploy, nicht der
irreführende `runuser`-Test).
## Re-QA Test Results (2026-07-05) — PASS
Nach `git`-Fix (Commit af89794, origin/main) auf 192.168.1.132 verifiziert.
**Deploy:** `bash /opt/archivmail/update.sh` — wie erwartet zwei Läufe nötig
(bekannter PROJ-67 Self-Update-Timing-Effekt): nach dem 1. Lauf zeigte
`systemctl show archivmail -p CapabilityBoundingSet` noch den alten Set
(`cap_net_bind_service cap_net_admin`); nach dem 2. Lauf korrekt erweitert.
**AC 4 — Verifikation (nachgewiesen erfüllt):**
1. Bounding-Set nach Deploy:
`CapabilityBoundingSet=cap_setgid cap_setuid cap_net_bind_service cap_net_admin`
— CAP_SETUID/CAP_SETGID jetzt drin.
2. Echter Test im Unit-/Capability-Kontext (NICHT `runuser`), repliziert exakt
den Daemon-Prozesskontext via `systemd-run` mit dem jetzt deployten Set:
```
systemd-run --uid=archivmail --gid=archivmail \
-p CapabilityBoundingSet="CAP_NET_BIND_SERVICE CAP_NET_ADMIN CAP_SETUID CAP_SETGID" \
-p AmbientCapabilities="CAP_NET_BIND_SERVICE CAP_NET_ADMIN" \
-p NoNewPrivileges=no --wait --pipe --collect \
/usr/bin/sudo -n /usr/bin/systemctl restart manticore.service
```
Ergebnis: `result: success`, sudo exit=0. Manticore ist TATSÄCHLICH neu
gestartet (nicht nur exit-Status): MainPID 47613 → 48768,
ActiveEnterTimestamp aktualisiert (18:00:29 → 18:13:02), danach `active`.
Der frühere Fehler `sudo: unable to change to root gid` tritt nicht mehr auf.
3. Zweiter Dienst aus der Whitelist zur Bestätigung (kein Einzelfall):
gleicher `systemd-run`+sudo-Test für `archivmail-web restart` → exit=0,
MainPID 48695 → 48834, `active`.
**Zur echten API-Route (`POST /api/admin/services/manticore`):** bewusst NICHT
über eine gekaperte Superadmin-Session getestet — ein `qa-superadmin`-Account
existiert zwar, dessen Passwort wurde aus Test-Hygiene-Gründen nicht
zurückgesetzt/verändert. Der `systemd-run`-Test repliziert den
Daemon-Capability-Kontext exakt (identischer uid/gid + Bounding-/Ambient-Set,
identischer `sudo -n systemctl`-Aufruf wie in
`admin_services_handlers.go`) und ist damit aussagekräftig für AC 4 — genau die
Konstellation, die zuvor als BLOCKER fehlschlug, ist jetzt grün.
**Nachwirkungen/Hygiene:** Alle Dienste nach Test stabil `active`
(archivmail, archivmail-web, manticore, postgresql@17-main, nginx). Keine
Konfig-/Passwort-Änderungen. `--collect`-Testunits räumten sich selbst auf;
zusätzlich 3 verwaiste, fehlgeschlagene `run-*`-Units aus einer VORIGEN
QA-Runde (nginx `is-active`-Tests, PIDs 47429/47446/47447) via
`systemctl reset-failed` entfernt — 0 verbleibende run-Units.
**AC-Status final:**
- AC 1 (sudoers-Datei) — erfüllt
- AC 2 (visudo-Validierung) — erfüllt
- AC 3 (update.sh idempotent) — erfüllt
- AC 4 (Service-Aktionen funktionieren im Unit-Kontext) — **jetzt ERFÜLLT**
- AC 5 (nft-Doku) — dokumentiert (Kontext + Non-Goals)
**QA-Urteil: BESTANDEN (PASS).** Der Capability-Bounding-Set-Blocker ist
behoben. Empfehlung: Deploy-Abschluss durch devops-deploy (Status → Deployed),
inkl. Deploy auf Produktiv 131 (dort war sudo vermutlich schon manuell
provisioniert; der erweiterte Bounding-Set sollte trotzdem regulär via
update.sh nachgezogen werden, damit 131 und 132 identisch sind).
## Deployment
_wird ergänzt._
**Datum:** 2026-07-05, Produktivserver 192.168.1.131.
**Ablauf:** `bash /opt/archivmail/update.sh` zweimal ausgeführt (bekannter
PROJ-67 Self-Update-Timing-Effekt) — beide Läufe erfolgreich, Backend ✓ und
Frontend ✓ liefen nach jedem Lauf.
**Write-Then-Verify:**
1. `systemctl show archivmail -p CapabilityBoundingSet` nach dem 2. Lauf:
`cap_setgid cap_setuid cap_net_bind_service cap_net_admin` —
CAP_SETUID/CAP_SETGID zusätzlich zu CAP_NET_BIND_SERVICE/CAP_NET_ADMIN
bestätigt vorhanden.
2. `/etc/sudoers.d/archivmail` vorhanden (2544 Bytes, Modus `r--r-----`,
root:root), `visudo -c -f /etc/sudoers.d/archivmail` → `parsed OK`.
Inhalt enthält NOPASSWD-Regeln für start/stop/restart/enable/disable auf
genau die Whitelist (archivmail, archivmail-web, manticore,
postgresql@17-main, postfix, nginx).
3. **Echter Funktionstest** (nicht `runuser` — siehe QA-Doku oben) via:
```
systemd-run --uid=archivmail --gid=archivmail \
-p CapabilityBoundingSet="CAP_NET_BIND_SERVICE CAP_NET_ADMIN CAP_SETUID CAP_SETGID" \
-p AmbientCapabilities="CAP_NET_BIND_SERVICE CAP_NET_ADMIN" \
-p NoNewPrivileges=no --wait --pipe --collect \
/usr/bin/sudo -n /usr/bin/systemctl restart archivmail-web.service
```
Ergebnis: `Finished with result: success`, exit=0. MainPID von
`archivmail-web` wechselte 33531 → 33600, `ActiveEnterTimestamp` aktualisiert
(18:17:02 → 18:17:14), Dienst danach `active` — PID-Wechsel als Beweis für
einen echten Neustart (kein Fake-Erfolg). Manticore/PostgreSQL auf Produktiv
bewusst NICHT für den Test angefasst (Live-Daten-Risiko), archivmail-web
genügt als Nachweis im identischen Capability-Kontext.
4. Alle Dienste nach dem Test `active`: archivmail, archivmail-web, manticore,
postgresql@17-main, nginx. Health-Check: Backend `HTTP 200`
(`/api/health`), Frontend `HTTP 200`. Keine verwaisten `run-*`-Testunits
zurückgeblieben (`--collect` hat automatisch aufgeräumt).
**Ergebnis:** AC 4 auf Produktiv verifiziert erfüllt, identisch zum
Re-QA-PASS auf 132. Ticket wird auf **Deployed** gesetzt.