Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a22669fa31 | ||
|
|
fe83636f99 | ||
|
|
c49e59b798 |
No files matched your search
@@ -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.
|
- 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.
|
- 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
|
## 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`.
|
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`.
|
||||||
|
|||||||
+28
-2
@@ -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` |
|
| Sicherungen | `backups/<project>/<environment>/<UTC-Zeit>-<commit>.tar.gz` |
|
||||||
| Netzwerk | Kein vom Manager veröffentlichter Hostport; ausgehend Quellen/Downloads und SSH/HTTPS zu Strato |
|
| 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 |
|
| 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.
|
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.
|
||||||
|
|
||||||
@@ -68,4 +68,30 @@ Backups enthalten `.env`, persistente Dateien und den durch den Backup-Hook erze
|
|||||||
- Ausführung: Runner-Status, Job-Schritte, Rückgabecode und Gitea-Logs.
|
- Ausführung: Runner-Status, Job-Schritte, Rückgabecode und Gitea-Logs.
|
||||||
- Strato: HTTPS-Healthcheck nach Aktivierung; zusätzlich aktive Release-Verknüpfung und `REVISION` kontrollieren.
|
- Strato: HTTPS-Healthcheck nach Aktivierung; zusätzlich aktive Release-Verknüpfung und `REVISION` kontrollieren.
|
||||||
|
|
||||||
Ein Container-Lebenszeichen wäre kein Beleg für ein funktionierendes Deployment. Maßgeblich ist der vollständige Auftrag bis zur erreichbaren Anwendung.
|
Ein Container-Lebenszeichen wäre kein Beleg für ein funktionierendes Deployment. Maßgeblich ist der vollständige Auftrag bis zur erreichbaren Anwendung.
|
||||||
|
## Weitere Pilotbefunde
|
||||||
|
|
||||||
|
- 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.
|
||||||
|
## 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.
|
||||||
|
**Wiederholungsnachweis:** Auch [FeWo-Lauf 4658](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4658) nach Veröffentlichung der abschließenden FeWo-Dokumentation ist erfolgreich. Commit `1b03689c46ce60a903af00a89bb79b4934532779`, Release `20261026135454-1b03689c`, erneut 285 Tests / 1289 Assertions grün. Neue Sicherung unter `backups/fewo-stommer/staging/20261026135454-1b03689c.tar.gz`, Datenbank-Hook erfolgreich. Anschließend Server-Commit, einzige aktive Release-Version und freigegebene Sperre per SSH bestätigt; dieselben fünf HTTPS-Pfade erneut HTTP 200. Damit ist auch der Folgeauftrag gegen eine bereits vom Manager installierte Version nachgewiesen.
|
||||||
@@ -35,4 +35,11 @@ Das aktuelle Image enthält PHP 8.4, Composer 2, Node 22/npm, Python 3, Git, SSH
|
|||||||
|
|
||||||
Dies ist ein Entwurf, noch kein getestetes Profil. Das Gitea-Projekt kann die festgelegte MediaWiki-Version aus einer externen Quelle mit Prüfsumme bzw. festem Commit beziehen und mit versionierten Erweiterungen sowie nicht geheimen Konfigurationsvorlagen kombinieren. Herkunft und Version aller Bestandteile müssen im Projekt nachvollziehbar bleiben. Die allgemeinen Paket-/Übertragungsschritte ändern sich dadurch nicht.
|
Dies ist ein Entwurf, noch kein getestetes Profil. Das Gitea-Projekt kann die festgelegte MediaWiki-Version aus einer externen Quelle mit Prüfsumme bzw. festem Commit beziehen und mit versionierten Erweiterungen sowie nicht geheimen Konfigurationsvorlagen kombinieren. Herkunft und Version aller Bestandteile müssen im Projekt nachvollziehbar bleiben. Die allgemeinen Paket-/Übertragungsschritte ändern sich dadurch nicht.
|
||||||
|
|
||||||
Vor Umsetzung sind die tatsächliche MediaWiki-Version, Erweiterungen, benötigte PHP-Erweiterungen, Tests und Wartungskommandos zu ermitteln. Uploads und geheime lokale Konfiguration gehören in `shared`. Datenbank-Backup, Wartungsfenster, Schema-Aktualisierung und ein möglicher Wiederherstellungsweg müssen projektspezifisch festgelegt werden. Keine FeWo-Artisan-Befehle übernehmen. Der öffentliche Verzeichnispfad muss zum zusammengestellten Paket passen; Dateien außerhalb dieses Pfads sind über den Manager-Zugang gesperrt.
|
Vor Umsetzung sind die tatsächliche MediaWiki-Version, Erweiterungen, benötigte PHP-Erweiterungen, Tests und Wartungskommandos zu ermitteln. Uploads und geheime lokale Konfiguration gehören in `shared`. Datenbank-Backup, Wartungsfenster, Schema-Aktualisierung und ein möglicher Wiederherstellungsweg müssen projektspezifisch festgelegt werden. Keine FeWo-Artisan-Befehle übernehmen. Der öffentliche Verzeichnispfad muss zum zusammengestellten Paket passen; Dateien außerhalb dieses Pfads sind über den Manager-Zugang gesperrt.
|
||||||
|
## Hinweis im AGENTS.md des angebundenen Projekts
|
||||||
|
|
||||||
|
Damit ein Agent im Anwendungsrepository die gemeinsame Werkzeugkette findet, dort einen Hinweis nach diesem Muster hinterlegen und die konkrete freigegebene Version im Projekt pflegen:
|
||||||
|
|
||||||
|
> Deployments laufen über Gitea mit PipelineManager: https://gitea.stommer.de/Lars/PipelineManager. Vor Pipeline-Änderungen dessen README, AGENTS.md und docs/PROJEKTE-ANBINDEN.md lesen. Dieses Projekt definiert seine Befehle und Ziele in pipeline.toml. Push auf develop testet und deployt Staging; Produktion nur über den vereinbarten Merge nach main und ein ausdrücklich freigegebenes Ziel. Werkzeuge werden im zentralen Image gepflegt, projektspezifische Abläufe hier. Keine lokalen Builds als Voraussetzung für automatische Deployments und keine Geheimnisse im Repository.
|
||||||
|
|
||||||
|
Die FeWo-Anbindung enthält diesen Verweis bereits. Die Wiki-Anbindung muss ihn bei ihrer Einrichtung übernehmen.
|
||||||
@@ -57,6 +57,7 @@ jobs:
|
|||||||
set -eu
|
set -eu
|
||||||
docker run --rm --user "$(id -u):$(id -g)" --cpus=1 --memory=512m --pids-limit=128 \
|
docker run --rm --user "$(id -u):$(id -g)" --cpus=1 --memory=512m --pids-limit=128 \
|
||||||
-e GITHUB_REF -e GITHUB_SHA -e DEPLOY_HOST -e DEPLOY_USER -e DEPLOY_SSH_KEY -e DEPLOY_KNOWN_HOSTS \
|
-e GITHUB_REF -e GITHUB_SHA -e DEPLOY_HOST -e DEPLOY_USER -e DEPLOY_SSH_KEY -e DEPLOY_KNOWN_HOSTS \
|
||||||
|
-v /etc/passwd:/etc/passwd:ro \
|
||||||
-v "$(pwd -P):/workspace:ro" \
|
-v "$(pwd -P):/workspace:ro" \
|
||||||
-v "$PIPELINE_HOME/backups:/backups" "$PIPELINE_IMAGE" \
|
-v "$PIPELINE_HOME/backups:/backups" "$PIPELINE_IMAGE" \
|
||||||
pipeline-manager deploy --environment "$TARGET" --backup-root /backups
|
pipeline-manager deploy --environment "$TARGET" --backup-root /backups
|
||||||
Reference in new issue
Block a user