Erfolgreichen FeWo-Strato-Pilot und Architekturablauf dokumentieren
PipelineManager Image / image (push) Successful in 9s

This commit is contained in:
Lars Stommer committed 2026-10-26 14:52:28 +01:00
1 parent c49e59b798
commit fe83636f99
2 files changed
+40 -2

No files matched your search

+18
View File
@@ -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:<commit>`. 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`.
+22 -2
View File
@@ -21,7 +21,7 @@ Kein dauerhaft laufender Manager, keine eigene HTTP-API, keine zusätzlichen Por
| Sicherungen | `backups/<project>/<environment>/<UTC-Zeit>-<commit>.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.
- 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.