From b544adac62985a71ab7d4decfe51bed25c85fd5d Mon Sep 17 00:00:00 2001 From: Lars Stommer Date: Thu, 22 Oct 2026 16:43:37 +0200 Subject: [PATCH] Docs: staging on stommer.info, OPcache-safe release switching Co-Authored-By: Claude Opus 5.5 --- docs/DEPLOYMENT.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 1bf705b..29279ba 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -13,7 +13,7 @@ ## 1. Prinzip shared/.env ◄─ einmalig von Hand shared/storage/ ◄─ Uploads, Logs, Sessions (bleiben) current ──► releases/… ◄─ atomar umgeschaltet nach migrate + optimize - Domain-Zielverzeichnis = /current/public + .htaccess ──► releases//public (Domain-Zielverzeichnis = ) │ ▼ https://…/up – Gesundheitscheck, bei Fehler automatischer Rollback ``` @@ -51,7 +51,7 @@ ## 3. Einmalige Einrichtung bei Strato bash scripts/deploy.sh production artisan db:seed --class=ProductionSeeder --force bash scripts/deploy.sh production artisan make:filament-user ``` -10. **Domain-Zielverzeichnis** auf den Ordner `` selbst setzen (Strato kann kein Symlink-Ziel wählen). `setup` legt dort eine `.htaccess` an, die alles intern nach `current/public` leitet, interne Dateien sperrt (403) und per `AddType application/x-httpd-php84 .php` die Web-PHP-Version **nur für diesen Ordner** auf die CLI-Version setzt – andere Anwendungen im Paket bleiben unberührt. SSL-Zertifikat für die Domain aktivieren. +10. **Domain-Zielverzeichnis** auf den Ordner `` selbst setzen (Strato kann kein Symlink-Ziel wählen). Die `.htaccess` dort (von `setup` und bei jedem Umschalten neu geschrieben) leitet alles intern nach `releases//public` – bewusst **nicht** über den Symlink `current`, weil der OPcache von Strato Skripte unter dem Symlink-Pfad zwischenspeichert und sonst nach dem Umschalten die alte Version ausliefert. Sie interne Dateien sperrt (403) und per `AddType application/x-httpd-php84 .php` die Web-PHP-Version **nur für diesen Ordner** auf die CLI-Version setzt – andere Anwendungen im Paket bleiben unberührt. SSL-Zertifikat für die Domain aktivieren. 11. **Cronjob** (Kundenlogin › Cronjobs), jede Minute: ``` /opt/RZphp84/bin/php-cli //current/artisan schedule:run @@ -83,5 +83,7 @@ ## 6. Getestet / offen - Lokal im Testmodus (`DEPLOY_HOST=local`) erfolgreich: Build (~19 MB), Upload, Entpacken, alle Migrationen auf frischer Datenbank, `optimize`, Ersteinrichtung per `ProductionSeeder`, alle Seiten und Admin-Login liefern 200. - **Nicht** unter Windows prüfbar: der Symlink-Wechsel von `current` (Git Bash legt Kopien statt Symlinks an). Unter Linux (Strato) ist das Standardverhalten; der erste Lauf auf dem Testbetrieb bestätigt es – bei Fehler greift der automatische Rollback. - **Auf Strato erfolgreich (22.10.2026, test.fewo-stommer.de):** SSH mit Schlüssel (paketspezifischer Server), PHP-CLI `/opt/RZphp84/bin/php-cli`, Migrationen auf MariaDB, Symlink-Umschaltung, `.htaccess`-Weiterleitung, Web-PHP 8.4 per `AddType`, `ProductionSeeder`; alle Seiten 200. -- Noch offen: SSL für die Subdomain, Cronjob, Gesundheitscheck über HTTPS. +- Testbetrieb läuft unter **https://stommer.info** (Domain-Ziel: Ordner `test.fewo-stommer.de`; SSL für Subdomains ist im Paket nicht verfügbar). Gesundheitscheck über HTTPS mit automatischem Rollback funktioniert. +- Behoben: OPcache lieferte nach dem Umschalten die alte Version (→ `.htaccess` zeigt auf den konkreten Release-Ordner); URLs mit `/current/public` (→ `URL::forceRootUrl(APP_URL)` außerhalb von local/testing). +- Noch offen: Cronjob. - Erstes Deployment auf ein neues Ziel: `SKIP_HEALTH_CHECK=1 bash scripts/deploy.sh deploy` (die Domain zeigt da noch nicht auf die neue Installation).