From fe83636f9922a92b55b9b23253801685750479e8 Mon Sep 17 00:00:00 2001 From: Lars Stommer Date: Mon, 26 Oct 2026 14:52:28 +0100 Subject: [PATCH] Erfolgreichen FeWo-Strato-Pilot und Architekturablauf dokumentieren --- README.md | 18 ++++++++++++++++++ docs/BETRIEB.md | 24 ++++++++++++++++++++++-- 2 files changed, 40 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 824a8f3..5434fa9 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,24 @@ Gemeinsame, versionierte Werkzeuge für Tests, Dateivorbereitung und atomare Dep - Jede Anwendung enthält eine `pipeline.toml`: eigene Vorbereitungs- und Testbefehle, benötigte Dateien, persistente Pfade und Zielverzeichnisse. Fachlogik und Mandantendaten bleiben in der Anwendung. - Gitea startet die Aufträge. Ein zusätzlicher HTTP-Dienst ist für Version 0.1 nicht erforderlich. +## Ablauf eines Anwendungsdeployments + +```mermaid +flowchart TD + Push[Push develop / Merge nach main] --> Gitea[Gitea-Workflow auf dem Runner] + Image[Vorhandenes freigegebenes Werkzeug-Image] --> Build + Image --> Deploy + Gitea --> Build[Container: Commit vorbereiten und testen] + Build --> Paket[Geprüftes Paket und SHA256] + Paket --> Deploy[Container: sichern und deployen] + Secrets[Gitea Secrets] --> Deploy + Deploy --> Strato[Strato: shared erhalten, neue Version aktivieren] + Strato --> Health[HTTPS-Healthcheck] + Health --> Ergebnis[Ergebnis und Logs in Gitea] +``` + +Die Container sind aufeinanderfolgende Prozesse auf dem Pi. Es gibt keinen Container, der einen weiteren Container erzeugt. Das Werkzeug-Image bleibt erhalten; Paketvorbereitung und Deployment verwenden dieselbe festgelegte Version. Abhängigkeiten des Projekts werden nach seinen Lockdateien installiert, gemeinsame Downloads bleiben im Cache. + ## Image-Lebenszyklus Ein Push auf `main` oder `develop` baut auf `Raspi5-Paperless` (bestehendes Label `ubuntu-latest`) ein Kandidaten-Image `pipeline-manager:`. Der Docker-Build installiert die Werkzeuge im Image und führt die Manager-Tests aus. Auf dem Host werden keine Pakete installiert. Der Ansatz folgt Tsumugus vorhandenen Docker-Aufträgen, verwendet aber Docker-Caches statt `--no-cache`. diff --git a/docs/BETRIEB.md b/docs/BETRIEB.md index 0b9802f..cbf253d 100644 --- a/docs/BETRIEB.md +++ b/docs/BETRIEB.md @@ -21,7 +21,7 @@ Kein dauerhaft laufender Manager, keine eigene HTTP-API, keine zusätzlichen Por | Sicherungen | `backups///-.tar.gz` | | Netzwerk | Kein vom Manager veröffentlichter Hostport; ausgehend Quellen/Downloads und SSH/HTTPS zu Strato | | Erstes Image | `pipeline-manager:0.1.0`, Tag `v0.1.0`, Commit `0e44a42`; Freigabelauf 4649 erfolgreich | -| Nächste Werkzeugversion | `0.1.1`: ergänzt im FeWo-Pilot fehlende GD-WebP-Unterstützung; Freigabenachweis wird ergänzt | +| Aktuell freigegeben | `pipeline-manager:0.1.1`, Tag `v0.1.1`, Commit `34b6b01`; Kandidatenlauf 4652 und Freigabelauf 4653 erfolgreich | Die Manager-Verzeichnisse wurden tatsächlich auf dem Pi angelegt und mit restriktiven Rechten geprüft. Bestehende Portbelegung wurde im Image-Lauf 4648 gelesen; andere Anwendungen wurden nicht geändert. Das Image liegt lokal auf diesem Runner. Vor Ausweitung auf andere Rechner Architektur und Imagebereitstellung klären. Das Label ist kein dauerhafter Identitätsnachweis: bei zusätzlichen Runnern mit demselben Label muss die Zuordnung eindeutiger werden. @@ -73,4 +73,24 @@ Ein Container-Lebenszeichen wäre kein Beleg für ein funktionierendes Deploymen - Image-Kandidat 0.1.1, Commit `34b6b01`: Lauf 4652 grün; Versionsfreigabe `v0.1.1`: Lauf 4653 grün. - FeWo-Lauf 4654: 285 Tests grün und Paket mit 10.552 Vendor-Dateien erstellt. Deployment stoppte vor SSH-Verbindung mit `No user exists for uid 1000`. Das Image enthält keinen festen Pi-Benutzer. Der Deployment-Aufruf bindet deshalb die Benutzerliste `/etc/passwd` des Linux-Runners schreibgeschützt ein, damit OpenSSH die mit `--user` gewählte UID auflösen kann. Die Passwort-Hashes aus `/etc/shadow` werden nicht eingebunden. Die Workflow-Vorlage enthält diese Zuordnung. -- Docker meldet auf dem Pi fehlende Memory-Cgroup-Unterstützung: `--memory` wird dort verworfen. Diese Option ist derzeit keine durchgesetzte Speichergrenze. PHP-Tests sind separat auf 512 MB begrenzt; für verbindliche Container-Speichergrenzen ist eine gesonderte Pi-Betriebskonfiguration nötig. Keine Kernel-/Hostkonfiguration wurde während des Piloten verändert. \ No newline at end of file +- Docker meldet auf dem Pi fehlende Memory-Cgroup-Unterstützung: `--memory` wird dort verworfen. Diese Option ist derzeit keine durchgesetzte Speichergrenze. PHP-Tests sind separat auf 512 MB begrenzt; für verbindliche Container-Speichergrenzen ist eine gesonderte Pi-Betriebskonfiguration nötig. Keine Kernel-/Hostkonfiguration wurde während des Piloten verändert. +## Erster vollständiger Strato-Nachweis + +Am 26.10.2026 erfolgreich, automatisch durch Push auf `develop`: + +| Prüfung | Nachweis | +|---|---| +| FeWo-Workflow | [Lauf 4656](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4656), Job 9044, Raspi5-Paperless | +| Quellstand | `e7f79e40756a0a8b5108f3b679a649bddb7df992` | +| Werkzeug-Image | `pipeline-manager:0.1.1` | +| Anwendungstests | 285 Tests, 1289 Assertions, grün im Pi-Container, ca. 52 Sekunden | +| Laufzeitpaket | Composer ohne Entwicklungsabhängigkeiten, Assets gebaut, 10.552 Vendor-Dateien nach Bereinigung | +| Sicherung vor Upload | Manager prüft TAR; persistent auf dem Pi: `/home/lars/docker/pipeline-manager/backups/fewo-stommer/staging/20261026134851-e7f79e40.tar.gz` | +| Datenbank-Dump | Backup-Hook erstellt `storage/app/private/backups/fewo-20261026-144859.sql.gz`, ca. 21 KB; im gesicherten `shared` enthalten | +| Release auf Strato | `test.fewo-stommer.de/releases/20261026134851-e7f79e40` | +| Serverprüfung per SSH | `current` und `REVISION` passen; nur aktive Release-Version vorhanden; keine Deploy-Sperre verblieben | +| Persistente Pfade | `.env`, `storage`, `public/storage` verweisen auf das bestehende `shared` im Staging-Ziel | +| Automatischer Healthcheck | Erfolgreich, danach Bereinigung; Workflow abgeschlossen mit success | +| Zusätzliche HTTPS-Prüfung | `/up`, `/`, `/wohnung`, `/buchen`, `/admin/login`: jeweils HTTP 200 | + +Der Nachweis bestätigt Paketvorbereitung, Tests, Sicherung, Übertragung, Aktivierung und Erreichbarkeit. Er ist kein praktisch ausgeführter Datenbank-Restore oder absichtlich herbeigeführter Remote-Rollback. Letzterer ist bislang durch Manager-Tests abgedeckt. Produktion wurde weder freigegeben noch deployt. Folgende reine Dokumentations-Commits können einen erneuten Testdeploy auslösen; der erste vollständige Nachweis oben bleibt dabei unverändert nachvollziehbar. \ No newline at end of file