Halte fest, was Gitea und der Runner für ein Release-Gate hergeben, damit P7 auf geprüften Annahmen aufbaut.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
1a2c959309
commit
1765714ccd
1 file changed
+61
@@ -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 `<Workflow-Name> / <Job> (<Event>)`, 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.<id>.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-<run>`), 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 |
|
||||
Reference in new issue
Block a user