Erprobten Pipeline-Weg und Agentenregeln für FeWo festhalten
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m44s

This commit is contained in:
Lars Stommer committed 2026-10-26 14:52:59 +01:00
1 parent e7f79e4075
commit 1b03689c46
4 files changed
+15 -12

No files matched your search

+1
View File
@@ -86,6 +86,7 @@ ## 5. Automatisch über Gitea Actions
- Produktion ist derzeit `enabled=false`: Der Workflow überspringt Vorbereitung und Deployment. Eigenständige Produktionsdatenbank, `.env` und Domain-Zuordnung müssen vor Freigabe eingerichtet werden. Das bestehende WordPress-Verzeichnis `www.fewo-stommer.de/` bleibt unangetastet.
- Die 18 Manager-Tests liegen im separaten Repository; die Anwendung behält ihre 285 Feature-Tests. Kein `setup-php`, kein `setup-node`, keine Toolinstallation auf dem Pi-Host. Der bisherige Node-24-/PHP-Setup-Fehler entfällt damit.
- Build und Deployment laufen in getrennten Containeraufrufen mit UID/GID des Runners und Ressourcenlimits. Nur der Deployment-Container erhält die Strato-Zugänge. Er bekommt weder den Docker-Socket noch Verzeichnisse anderer Anwendungen.
- OpenSSH benötigt eine auflösbare lokale UID: Der Deployment-Container erhält `/etc/passwd` des Linux-Runners schreibgeschützt, keine Passwort-Hashes. Docker meldet auf dem Pi fehlende Memory-Cgroup-Unterstützung; `--memory` wird dort derzeit nicht durchgesetzt. Die PHP-Tests haben zusätzlich ein eigenes Limit von 512 MB. Eine Änderung der Pi-Kernelkonfiguration gehört nicht zum Anwendungsdeploy.
- Persistente Verzeichnisse auf dem Pi: `/home/lars/docker/pipeline-manager/cache` (Composer/npm) und `backups/<project>/<environment>` (Datenbank, Medien und Server-Konfiguration). Backups werden vor dem Upload geprüft; ein Fehler verhindert die Auslieferung. Eine Sperre auf Strato verhindert parallele Umschaltungen desselben Ziels.
- Repository-Secrets sind eingerichtet: `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_SSH_KEY` (eigener Pipeline-Schlüssel), `DEPLOY_KNOWN_HOSTS` (geprüfter Hostschlüssel). Geheimnisse bleiben außerhalb von Image und Repository. Der Manager schreibt sie nur vorübergehend in geschützte Dateien.
- Die auf dem Pi freigegebene Image-Version muss vor dem FeWo-Workflow vorhanden sein. Für weitere Runner mit anderer Architektur ist eine entsprechende Imagebereitstellung erforderlich. Erst nach erfolgreichem Pilotlauf wird der alte manuelle Deploy-Weg ersetzt.