diff --git a/docs/betrieb/BESTANDSAUFNAHME_GITEA_RUNNER_2026-10-22.md b/docs/betrieb/BESTANDSAUFNAHME_GITEA_RUNNER_2026-10-22.md new file mode 100644 index 0000000..30c6c3a --- /dev/null +++ b/docs/betrieb/BESTANDSAUFNAHME_GITEA_RUNNER_2026-10-22.md @@ -0,0 +1,61 @@ +# Bestandsaufnahme Gitea und Runner (P7, Schritt 1) + +**Stand:** 22.10.2026 · Auftrag: [Release-Gate, Backup und Restore](../product/TSUMUGU_RELEASE_GATE_BACKUP_AUFTRAG_2026-10-22.md), Abschnitt 5.1 · Nur lesend erhoben, nichts am Server oder Pi verändert. + +**Nachweisarten:** **B** = am Server beobachtet (anonyme API, öffentliche Job-Logs) · **D** = aus Gitea-Dokumentation für 1.22, am Server nicht ausprobiert · **O** = offen, braucht Admin-Zugang oder Sicht auf den Pi. + +## 1. Gitea-Server `192.168.2.144:3000` (auch `gitea.stommer.de`) + +| Punkt | Befund | Art | +|---|---|---| +| Version | Gitea **1.22.0** | B | +| Sichtbarkeit des Repos | `Lars/tsumugu` ist **öffentlich**. Code, Pull Requests, Commit-Status und **Job-Logs** sind ohne Anmeldung lesbar (z. B. `/Lars/tsumugu/actions/runs/149/jobs/0/logs`). | B | +| Branch-Schutz | `main` und `develop`: `protected=false`, keine Pflicht-Statuschecks, keine Pflicht-Reviews. Jeder mit Schreibrecht kann direkt auf `main` pushen und damit Prod deployen. | B | +| Merge-Stile | Merge, Rebase, Squash und Fast-Forward-only sind erlaubt; Default `merge` | B | +| Bisheriger Release-Weg | PR #1–#8 `develop → main`, jeweils von `Lars` gemergt. `main` steht auf `1bc464e` (18.10.2026). | B | +| Statuskontexte | Gitea setzt sie als ` / ()`, z. B. `Test Suite / pytest-backend (push)`, `Deploy Production / deploy (push)`. Diese Namen wären als Pflichtchecks verwendbar. | B | +| Pflicht-Statuschecks im Branch-Schutz | vorhanden, mit Mustern | D | +| Menschliche Freigabe per Review | Gitea lässt keine Freigabe des eigenen PR zu. Bei einem einzigen Nutzer `Lars` ist „1 Approval nötig“ nicht erfüllbar. Als Freigabe bleibt der bewusste Merge des Release-PR durch eine Person auf der Merge-Whitelist. | D | +| `jobs..environment` | wird ignoriert, ist kein Gate (Technische Spezifikation 8.2) | D | +| `concurrency` in Workflows | in 1.22 nicht unterstützt. Serialisierung muss auf dem Host entstehen (`flock`). | D | +| `workflow_dispatch` | Trigger vorhanden; Bedienung über Weboberfläche am Server noch nicht geprüft | D/O | +| Effektive Rechte, Collaborators, Push-/Merge-Whitelist, Repo-Secrets | Anonym nicht lesbar (`branch_protections` → 401) | O | + +## 2. Runner + +| Punkt | Befund | Art | +|---|---|---| +| Runner | `Raspi5-Paperless`, act_runner **v0.2.11**, Label `ubuntu-latest` | B (Job-Log) | +| Ausführungsmodus | **Host-Modus.** Die Logs zeigen kein Job-Image und kein `docker pull`; die Schritte arbeiten direkt in `/home/lars/docker/tsumugu*` und rufen `docker compose` des Hosts auf. | B | +| Isolation | **Keine.** Jeder Job läuft als Nutzer des Runners auf dem Pi mit Zugriff auf den Docker-Socket, also faktisch mit Root-Rechten. Er erreicht Prod-Checkout, `.env` mit `DB_PASSWORD`, Volumes `tsumugu-db-data` und `tsumugu-media` sowie die Stacks der anderen Produkte auf demselben Pi. | B | +| Mitbenutzung | Die Job-Nummern (8466, 8795) deuten auf einen Runner für mehrere Repositories. Workflows anderer Produkte haben damit dieselbe Reichweite auf Tsumugu-Prod. | B (Indiz) / O | +| Parallelität | Dev-Deploy und Test liefen auch bisher gleichzeitig; Kapazität des Runners nicht gesehen | O | +| Untrusted Code | Heute startet kein Workflow bei `pull_request`. Ein Fork-PR führt daher keinen Code aus. **Das muss so bleiben**, solange der Runner im Host-Modus läuft und das Repo öffentlich ist. | B | +| Werkzeuge auf dem Pi | `age`, `flock`, freier Platz, Ziel für eine Kopie außerhalb des Hosts | O | + +## 3. Weitere Beobachtungen für P7 + +- Die öffentlichen Job-Logs sind ein Kanal nach außen. Backup-, Restore- und Deploy-Schritte dürfen dort keine Secrets, Dateinamen aus der Medienablage oder Inhalte ausgeben. +- `backend/Dockerfile` enthält `tests/` nicht; heute läuft pytest im Laufzeitimage nach `pip install` gegen den eingehängten Checkout (R-27). Für „das gebaute Image testen“ braucht es eine Test-Stufe, die auf genau diesen Image-Schichten aufsetzt. +- Basisimages sind nicht gepinnt (`python:3.12-slim`, `postgres:16-alpine`, Frontend-Basis). Zwei Builds desselben Commits können sich unterscheiden. +- Der Migrator kapselt jede Datei in eine eigene Transaktion. Scheitert Datei *n*, bleiben 1…*n−1* committed. `docker compose up` hat den alten Backend-Container dann schon ersetzt; Prod steht still, bis ein Rückweg greift. +- Zwischen `main` (Prod) und `develop` liegen sieben Migrationen, darunter `20261021T150000Z_room_shares.sql` mit der nicht umkehrbaren Entfernung von `visibility`. Der nächste Merge nach `main` ist damit der erste, für den ein Backup vor der Migration zwingend ist. +- Für die Kontenquarantäne nach Restore gibt es schon `auth_accounts.status` (`active`/`disabled`) und die Tabelle `auth_sessions`. + +## 4. Folgerungen für den Entwurf + +1. **Gate im Prod-Workflow selbst, nicht im Branch-Schutz allein.** Der Branch-Schutz kann Pflichtchecks und eine Merge-Whitelist erzwingen, das ist ein guter Zusatz. Weil der Runner aber jeden Workflow eines Branches ausführt, prüft `deploy-prod` selbst: Merge-Commit stammt aus einem gemergten PR, der Develop-Stand hat einen grünen Qualifikationsnachweis im Host-Verzeichnis, Trees stimmen überein, frisches Backup liegt vor. Fehlt etwas, bricht der Lauf vor jeder Änderung ab. +2. **Menschliche Freigabe** = Merge des Release-PR durch `Lars` (Merge-Whitelist). Ein zusätzliches Review ist bei einem einzigen Nutzer technisch nicht möglich. +3. **Qualifikationsnachweise** liegen in einem Host-Verzeichnis außerhalb der Checkouts. Workflows können es trotzdem beschreiben; die Herkunft sichert nur der Branch-Schutz plus der Umstand, dass nur `develop`- und `main`-Pushes Workflows starten. Diese Grenze wird im Runbook benannt, nicht kaschiert. +4. **Testlauf** als eigenes Compose-Projekt je Lauf (`tsumugu-test-`), eigene Postgres ohne Hostport, Aufräumen auch bei Fehler. Serialisierung über `flock`, weil `concurrency` fehlt. +5. **Keine Workflows mit `pull_request`-Trigger** auf diesem Runner. + +## 5. Offene Punkte für den Nutzer + +| Nr. | Frage | Warum | +|---|---|---| +| O-1 | Bleibt das Repository öffentlich? | Öffentliche Job-Logs; ein privates Repo senkt das Risiko ohne Umbau | +| O-2 | Branch-Schutz für `main` setzen (kein direkter Push, Merge nur `Lars`, Pflichtcheck auf den Qualifikationslauf)? | Gitea-Einstellung, nur durch den Nutzer | +| O-3 | Lesender Blick auf den Pi: Runner-Konfiguration (`config.yaml`, Kapazität), Nutzer des Runners, `age`/`flock` vorhanden, freier Platz | Nicht anonym ermittelbar; ich habe keinen SSH-Zugang | +| O-4 | Ziel der Kopie außerhalb des Hosts (z. B. Synology `192.168.2.63`) und Transportweg | Lieferpunkt 4 | +| O-5 | Wo liegt der private `age`-Schlüssel (nicht auf dem Pi, nicht in CI)? | Lieferpunkt 4, Blueprint 10.3 |