86 lines
5.7 KiB
Markdown
86 lines
5.7 KiB
Markdown
# Deployment auf Strato
|
||
|
||
Stand: 22.10.2026 · Skript: `scripts/deploy.sh` · CI: `.gitea/workflows/deploy.yml`
|
||
|
||
## 1. Prinzip
|
||
|
||
```
|
||
Gitea (main/Tag) ──► Build (CI oder lokal): git-Stand · composer --no-dev · npm run build
|
||
│ tar.gz
|
||
▼ SSH
|
||
Strato <DEPLOY_PATH>/
|
||
releases/20261022…/ ◄─ entpackt
|
||
shared/.env ◄─ einmalig von Hand
|
||
shared/storage/ ◄─ Uploads, Logs, Sessions (bleiben)
|
||
current ──► releases/… ◄─ atomar umgeschaltet nach migrate + optimize
|
||
Domain-Zielverzeichnis = <DEPLOY_PATH>/current/public
|
||
│
|
||
▼ https://…/up – Gesundheitscheck, bei Fehler automatischer Rollback
|
||
```
|
||
|
||
Auf dem Server werden nur **bash, tar und PHP-CLI** gebraucht – kein Composer, kein Node, kein Git, kein rsync.
|
||
|
||
## 2. SSH oder SFTP?
|
||
|
||
**Empfehlung: SSH.** Das Skript führt nach dem Hochladen Befehle auf dem Server aus (Archiv entpacken, Datenbank migrieren, Caches erzeugen, Version umschalten, ggf. zurückschalten). Das geht nur mit SSH.
|
||
|
||
Nur mit SFTP wäre ein Deployment möglich, aber deutlich schwächer:
|
||
- Kein Entpacken auf dem Server → jede Datei einzeln übertragen (über 10.000 Dateien, mehrere Minuten pro Update, unterbrechungsanfällig).
|
||
- Migrationen und Caches müssten über einen gesicherten Web-Aufruf angestoßen werden; kein `artisan` für Wartung und Fehlersuche.
|
||
- Umschalten wäre per SFTP-Symlink möglich, aber ohne sauberen Rückfall bei Fehlern.
|
||
|
||
Strato richtet beide Zugänge im selben Menü ein (Kundenlogin › Datenbanken und Webspace › **SFTP & SSH**). Bei Hosting Pro sollte SSH enthalten sein – bitte dort prüfen. Falls nicht: Bescheid geben, dann ergänze ich einen SFTP-Modus.
|
||
|
||
## 3. Einmalige Einrichtung bei Strato
|
||
|
||
1. **PHP-Version** auf 8.4 stellen (Datenbanken und Webspace › PHP-Version).
|
||
2. **SSH-Zugang** anlegen (SFTP & SSH); Benutzername notieren. Eigenen SSH-Schlüssel hinterlegen oder einmalig `ssh-copy-id <benutzer>@ssh.strato.de`.
|
||
3. Per SSH prüfen:
|
||
```bash
|
||
ssh <benutzer>@ssh.strato.de
|
||
ls /opt | grep RZphp # PHP-CLI-Pfad, z. B. /opt/RZphp84/bin/php-cli
|
||
/opt/RZphp84/bin/php-cli -v
|
||
```
|
||
4. **Datenbank MariaDB 11.8** anlegen (Datenbanken verwalten; nicht MySQL 8.0 – Support endete im April 2026); Host, Name, Benutzer, Passwort notieren. In `shared/.env`: `DB_CONNECTION=mariadb`.
|
||
5. Lokal `scripts/deploy.example.env` nach `scripts/deploy.production.env` kopieren und ausfüllen (wird nicht committet).
|
||
6. `bash scripts/deploy.sh production setup` – legt die Ordner an und zeigt die PHP-Version.
|
||
7. `.env.production.example` ausfüllen (u. a. `APP_KEY` via `php artisan key:generate --show`, Datenbank, SMTP/IMAP-Passwort, Tokens) und auf den Server nach `<DEPLOY_PATH>/shared/.env` kopieren (z. B. per SFTP).
|
||
8. Erstes Deployment: `bash scripts/deploy.sh production deploy`
|
||
9. Ersteinrichtung der Daten und erster Admin:
|
||
```bash
|
||
bash scripts/deploy.sh production artisan db:seed --class=ProductionSeeder --force
|
||
bash scripts/deploy.sh production artisan make:filament-user
|
||
```
|
||
10. **Domain-Zielverzeichnis** (Domains › Domain verwalten › Ziel) auf `<DEPLOY_PATH>/current/public` setzen; SSL-Zertifikat aktivieren.
|
||
11. **Cronjob** (Kundenlogin › Cronjobs), jede Minute:
|
||
```
|
||
/opt/RZphp84/bin/php-cli <home>/<DEPLOY_PATH>/current/artisan schedule:run
|
||
```
|
||
Falls Cronjobs nicht minütlich möglich sind: `FEWO_SCHEDULER_TOKEN` setzen und n8n jede Minute `GET https://…/automation/scheduler?token=…` aufrufen lassen.
|
||
12. Überwachung: n8n alle 5 Min. `GET https://…/health/sync?token=<FEWO_HEALTH_TOKEN>` (200 = ok, 503 = Störung).
|
||
|
||
**Testbetrieb zuerst:** Für eine Subdomain (z. B. `test.fewo-stommer.de`) eine zweite Konfiguration `scripts/deploy.staging.env` mit eigenem `DEPLOY_PATH`, eigener Datenbank und eigenem `shared/.env` anlegen; `bash scripts/deploy.sh staging deploy`.
|
||
|
||
## 4. Tägliche Nutzung
|
||
|
||
| Aufgabe | Befehl |
|
||
|---|---|
|
||
| Neue Version ausliefern | `bash scripts/deploy.sh production deploy` (baut den **letzten Commit**) |
|
||
| Zurück zur vorigen Version | `bash scripts/deploy.sh production rollback` (Migrationen bleiben bestehen) |
|
||
| Versionen anzeigen | `bash scripts/deploy.sh production releases` |
|
||
| Artisan auf dem Server | `bash scripts/deploy.sh production artisan about` |
|
||
|
||
Windows: in Git Bash ausführen; `COMPOSER_BIN="php /c/…/composer.phar"` in der `.env`-Datei des Deployments setzen, falls `composer` nicht im PATH ist.
|
||
|
||
## 5. Automatisch über Gitea Actions
|
||
|
||
- Workflow `.gitea/workflows/deploy.yml`: **Tests bei jedem Push**; **Deployment** bei Tags `v*` (z. B. `git tag v1.0.0 && git push --tags`) oder per Knopfdruck (Actions › Deploy › Run workflow, Ziel production/staging).
|
||
- Voraussetzung: Gitea Actions aktiviert und ein **act_runner** registriert – passt gut auf den privaten Server (Docker). Anleitung: Gitea-Doku „Act Runner“.
|
||
- Repository-Secrets: `DEPLOY_SSH_KEY` (privater Schlüssel, dessen öffentlicher Teil bei Strato hinterlegt ist), `DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_PATH`, `DEPLOY_PHP`, `DEPLOY_URL`.
|
||
|
||
## 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.
|
||
- Bei Strato zu prüfen: SSH im Tarif, PHP-CLI-Pfad, ob das Domain-Ziel einem Symlink (`current`) folgt, minütliche Cronjobs.
|