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.
+4 -2
View File
@@ -1,6 +1,6 @@
# Projektstand
Stand: 26.10.2026 · ausgelieferter Stand: `deploy/staging/20261026072521` (`abf0e90`) · 285 Feature-Tests grün
Stand: 26.10.2026 · automatischer PipelineManager-Testdeploy erfolgreich (erster Nachweis: Lauf 4656, Commit `e7f79e4`) · 285 Feature-Tests grün
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
@@ -159,7 +159,9 @@ ### Phase 7: Kern umgesetzt und ausgeliefert
**Gemeinsamer PipelineManager (26.10., Pilotanbindung auf `feature/pipeline-manager-integration`):** Eigenes Repository [Lars/PipelineManager](https://gitea.stommer.de/Lars/PipelineManager), lokal `C:\dev\pipelinemanager`. Werkzeug-Image mit PHP/Composer/Node/Python/Git/SSH und gemeinsame Tests, Paketprüfung, Sicherung, Upload, Umschaltung und Rückfall. Nach dem Vorbild von Tsumugu baut der vorhandene Runner `Raspi5-Paperless` das Image im Docker; Anwendungen starten daraus ihre Aufträge. Image und Download-Caches werden wiederverwendet. FeWo liefert nur `pipeline.toml` mit Laravel-Befehlen und Zielen. Push `develop` → `test.fewo-stommer.de/`, Merge nach `main` → `prod.fewo-stommer.de/`; Produktion bleibt ausdrücklich gesperrt. Das leere Produktionsverzeichnis ist bereits angelegt, ohne `.env` oder Datenbank-Anbindung. Keine PHP-/Node-Installation mehr auf dem Host vorgesehen.
Der frühere lokale Paket-/Registry-Ansatz bleibt unveröffentlicht auf `feature/artifact-pipeline` und ist nicht Bestandteil der Pilotanbindung. Anwendung und Theme-Dateien unverändert. Pilot jetzt auf `develop`; eigener Pipeline-Schlüssel bei Strato autorisiert und privat ausschließlich außerhalb von Git bzw. als Gitea-Secret hinterlegt. Alle vier Deployment-Secrets sind eingerichtet. Die ersten Gitea-Läufe stoppten vor dem Upload: 4650 wegen PHP-Speicherlimit, 4651 wegen fehlender WebP-Unterstützung. Korrektur: FeWo-Tests mit 512 MB, neues Manager-Image `0.1.1` statt Änderung der freigegebenen Version `0.1.0`. **18 Manager-Tests lokal grün**. Verzeichnisse für Cache und Backups unter `/home/lars/docker/pipeline-manager/`, keine veröffentlichten Ports. Anleitung, Workflow-Vorlage und Agentenanweisungen im separaten Manager-Repository. Der tatsächliche Strato-Release steht oben; erfolgreicher Pilotnachweis wird nach Abschluss ergänzt. Tsumugu wurde ausschließlich gelesen.
Der frühere lokale Paket-/Registry-Ansatz bleibt unveröffentlicht auf `feature/artifact-pipeline` und ist nicht Bestandteil der Pilotanbindung. Anwendung und Theme-Dateien unverändert. **Pilot erfolgreich:** Push auf `develop` → Gitea-Lauf [4656](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4656), Commit `e7f79e4`, Release `20261026134851-e7f79e40`. **285 Feature-Tests / 1289 Assertions im Container grün**, Sicherung vor Upload, Aktivierung, automatischer HTTPS-Check und Bereinigung erfolgreich. Per SSH `REVISION`, einzige verbliebene Release-Version und Verknüpfungen auf `shared` geprüft; `/up`, `/`, `/wohnung`, `/buchen`, `/admin/login` jeweils HTTP 200. Sicherung auf dem Pi: `/home/lars/docker/pipeline-manager/backups/fewo-stommer/staging/20261026134851-e7f79e40.tar.gz` (enthält auch den vorher erzeugten Datenbank-Dump).
Werkzeugversion `0.1.1` aus Manager-Commit `34b6b01`: Kandidatenlauf 4652 und Freigabelauf 4653 grün, **18 Manager-Tests lokal und im Image grün**. Frühe Pilotfehler vor dem Serverzugriff wurden behoben: PHP-Testlimit 512 MB, GD mit WebP im Image, schreibgeschützte Benutzerliste des Runners für OpenSSH. Eigener Pipeline-Schlüssel bei Strato autorisiert, privater Teil als Gitea-Secret; alle vier Deployment-Secrets eingerichtet. Cache und Backups liegen unter `/home/lars/docker/pipeline-manager/`, keine veröffentlichten Ports. **Betriebsgrenze:** Der Pi setzt Docker-Speicherlimits mangels Memory-Cgroup-Unterstützung derzeit nicht durch; keine Host-/Kerneländerung vorgenommen. Anleitung, Workflow-Vorlage, Betriebsnachweise und `AGENTS.md` im separaten Manager-Repository. Produktion bleibt gesperrt. Tsumugu wurde ausschließlich gelesen.
**Nicht vergessen:** Jede neue Tabelle bekommt `tenant_id` von Anfang an und gehört in `TenantArchive::DELETE_ORDER`, sonst überlebt sie die Kündigung ihres Mandanten. `tests/Feature/TenantSeparationTest.php` merkt das – aber nur, wenn der Testaufbau dort die neue Tabelle auch füllt.
+6 -6
View File
@@ -6,7 +6,7 @@ ## 1. Wer arbeitet woran
| Session | Rechner | Aufgabe | Branch | Darf ändern |
|---|---|---|---|---|
| **A – Anwendung** | Firmen-Laptop (oder jeder andere) | Funktionen, Verwaltung, Abläufe, Betrieb, Deployment | `main` (größere Vorhaben: `feature/<thema>`) | alles **außer** `resources/themes/<neues-theme>/**` |
| **A – Anwendung** | Firmen-Laptop (oder jeder andere) | Funktionen, Verwaltung, Abläufe, Betrieb, Deployment | `develop` (größere Vorhaben: `feature/<thema>`) | alles **außer** `resources/themes/<neues-theme>/**` |
| **B – Design** | privater PC, Plugin `frontend-design` | ein **neues, zusätzliches Theme** | `theme/<key>` (z. B. `theme/ostsee-nacht`) | nur `resources/themes/<key>/**`, `package.json`/`package-lock.json` (nur `@fontsource`-Schriften), `docs/STATUS.md` (eigener Abschnitt) |
Session B ändert **nicht**: `app/**`, `config/**`, `database/**`, `routes/**`, `resources/views/**` (auch nicht die Livewire-Formulare), `resources/themes/ostsee-licht/**`, `public/brand/**`, andere Dokumente. Braucht das Theme etwas aus diesen Bereichen (neue Daten in einem Baustein, ein neuer Baustein, eine Schrift-Lizenzfrage …), trägt Session B den Wunsch in §5 ein. Session A setzt ihn um.
@@ -15,7 +15,7 @@ ## 2. Ablauf Session B (Design)
```bash
git clone https://gitea.stommer.de/Lars/fewo-stommer.git && cd fewo-stommer # einmalig
git checkout main && git pull
git checkout develop && git pull
git checkout -b theme/<key> # einmalig
php artisan themes:make <key> --name="…" --description="…"
# … arbeiten (docs/THEME-ERSTELLUNG.md) …
@@ -26,16 +26,16 @@ # … arbeiten (docs/THEME-ERSTELLUNG.md) …
**Täglich vor der Arbeit** den Stand der Anwendung übernehmen, damit Vorlagen-Vertrag und Tests aktuell sind:
```bash
git fetch origin && git merge origin/main # Konflikte kann es nur in package-lock.json geben, siehe §4
git fetch origin && git merge origin/develop # Konflikte kann es nur in package-lock.json geben, siehe §4
php artisan migrate && npm ci && php artisan test --compact
```
**Zusammenführen:** Sobald `php artisan themes:check <key>` ohne Fehler und `php artisan test --compact` grün ist, Merge-Request in Gitea von `theme/<key>` nach `main` – oder lokal `git checkout main && git pull && git merge --no-ff theme/<key> && git push`. Ein unfertiges Theme darf zusammengeführt werden. Es ist installiert, aber nicht aktiv, solange es niemand unter Admin › Websites auswählt. Zusammenführen hilft sogar, weil dann die Vorschau auf stommer.info möglich ist.
**Zusammenführen:** Sobald `php artisan themes:check <key>` ohne Fehler und `php artisan test --compact` grün ist, Merge-Request in Gitea von `theme/<key>` nach `develop` – oder lokal `git checkout develop && git pull && git merge --no-ff theme/<key> && git push`. Ein unfertiges Theme darf zusammengeführt werden. Es ist installiert, aber nicht aktiv, solange es niemand unter Admin › Websites auswählt. Zusammenführen hilft sogar, weil dann die Vorschau auf stommer.info möglich ist.
## 3. Ausliefern (Deployment)
- **Zielablauf mit PipelineManager:** Feature- und Theme-Branches gehen nach `develop`; dessen Push startet Tests und Deployment auf das Testsystem. Produktion entsteht durch Merge-Commit `develop` → `main` und ist bis zur Einrichtung gesperrt. Gemeinsame Deployment-Werkzeuge werden im separaten Repository PipelineManager gepflegt. Details und Freigabestand: `docs/DEPLOYMENT.md`, `docs/STATUS.md`. Bis der Pilot bestätigt ist, bleibt der bestehende manuelle Weg aus aktuellem `main` verfügbar.
- Theme-Vorschau auf stommer.info: erst nach dem Zusammenführen in `main`, dann `bash scripts/deploy.sh staging deploy` und `bash scripts/deploy.sh staging artisan themes:preview <key>` (gibt die Vorschau-Links aus).
- **Zielablauf mit PipelineManager:** Feature- und Theme-Branches gehen nach `develop`; dessen Push startet Tests und Deployment auf das Testsystem. Produktion entsteht durch Merge-Commit `develop` → `main` und ist bis zur Einrichtung gesperrt. Gemeinsame Deployment-Werkzeuge werden im separaten Repository PipelineManager gepflegt. Details und Freigabestand: `docs/DEPLOYMENT.md`, `docs/STATUS.md`. Der manuelle Weg bleibt als ausdrücklich gewählter Wartungsweg verfügbar; normale Auslieferungen laufen über Gitea.
- Theme-Vorschau auf stommer.info: nach dem Zusammenführen in `develop` und erfolgreichem automatischem Testdeploy; danach `bash scripts/deploy.sh staging artisan themes:preview <key>` (gibt die Vorschau-Links aus).
- Das neue Theme aktivieren (Admin › System › Websites › Theme) entscheidet Lars, nach Sichtung der Vorschau.
- `shared/.env` auf dem Server ändert nur Lars (Passwörter); Sessions ändern dort höchstens nicht geheime Werte und dokumentieren das in BETRIEB.md.
- Jede Session braucht ihren **eigenen SSH-Schlüssel** für Strato (BETRIEB.md §4); keine Schlüssel kopieren.