76 lines
5.9 KiB
Markdown
76 lines
5.9 KiB
Markdown
# LUF – Deployment (Stand 2026-11-15)
|
||
|
||
Abgeleitet aus dem Shinkan-Verfahren, siehe [Bestandsaufnahme_Deployment_2026-11-15.md](Bestandsaufnahme_Deployment_2026-11-15.md).
|
||
**Status: geschrieben, aber noch nicht gelaufen.** Es gibt noch keine Laravel-Anwendung im Repo (kommt mit U0), und lokal stehen weder Docker noch Composer zur Verfügung. Geprüft wurden nur Shell-Syntax und YAML.
|
||
|
||
## Ablauf
|
||
|
||
| Auslöser | Workflow | Schritte |
|
||
|---|---|---|
|
||
| Push auf `feature/**` | `ci-feature.yml` | Commit klonen, Test-Image bauen, Pint und `php artisan test` im Wegwerf-Container |
|
||
| Push auf `develop` | `deploy-test.yml` | Tests, dann Deploy Test (`luf-test`, Port 3011) |
|
||
| Push auf `main` | `deploy-prod.yml` | Tests auf genau diesem Commit, dann Deploy Prod (`luf-prod`, Port 3010) |
|
||
|
||
- Der Deploy-Job hat `needs: test`. Sind die Tests rot, läuft kein Deploy.
|
||
- Deployt wird der getestete Commit (`github.sha`), nicht der jeweils neueste Stand des Branches.
|
||
- `scripts/deploy.sh`: Konfigurationsprüfung, Portkonflikt-Prüfung, Build, DB starten, `migrate --force`, Start, Health (`/up` und Datenbankzugriff). Bei Fehler Rollback auf den letzten erfolgreichen Image-Tag (`.last_good_tag`).
|
||
- Ein Deploy gleichzeitig pro Host (`flock`), alte Images werden bis auf die letzten Tags entfernt.
|
||
- **Rollback betrifft nur den Code.** Migrationen werden nicht zurückgenommen. Migrationen müssen daher abwärtskompatibel sein (erst ergänzen, später entfernen).
|
||
|
||
## Trennung Test und Prod (beide auf llm-node)
|
||
|
||
| | Test | Prod |
|
||
|---|---|---|
|
||
| Branch | `develop` | `main` |
|
||
| Compose-Projekt | `luf-test` | `luf-prod` |
|
||
| Deploy-Verzeichnis | `/home/llmadmin/docker/luf-test` | `/home/llmadmin/docker/luf-prod` |
|
||
| Env-Datei | `/etc/luf/test.env` | `/etc/luf/prod.env` |
|
||
| Web-Port | 3011/tcp | 3010/tcp |
|
||
| Volumes, Netz, DB | eigene (Projekt-Präfix) | eigene (Projekt-Präfix) |
|
||
|
||
Ports aus der Momentaufnahme vom 2026-11-15 (frei laut `ss` und `docker ps`). Das Skript bricht ab, wenn der Port von einem fremden Dienst belegt ist. DB, PHP-FPM, Queue und Scheduler veröffentlichen keine Host-Ports.
|
||
|
||
## Medien-Ablage auf dem NAS
|
||
|
||
| | Test | Prod |
|
||
|---|---|---|
|
||
| NAS-Ordner [?] | `/volume1/luf_media_dev` | `/volume1/luf_media` |
|
||
| Mountpunkt auf llm-node | `/srv/luf/test/media` | `/srv/luf/prod/media` |
|
||
|
||
Der Pfad auf dem NAS ist aus den Ordnernamen abgeleitet und **nicht verifiziert**: Beide Ordner standen am 2026-11-15 nicht in der NFS-Exportliste des NAS (`showmount -e`).
|
||
|
||
Aufbau je Umgebung, nach `03_Zielarchitektur.md` (Zeilen 241/242) und `08_Medien_Streaming_Kennzeichnung.md` (Abschnitt 1):
|
||
|
||
| Ordner | `queue` (Hintergrundverarbeitung) | `app` (Web-Prozess) |
|
||
|---|---|---|
|
||
| `originals/` | lesen und schreiben | **kein Zugriff** (nicht gemountet) |
|
||
| `derived/` (privat) | lesen und schreiben | nur lesen |
|
||
| `public/` | lesen und schreiben | nur lesen |
|
||
|
||
- Die Trennung geschieht über getrennte Bind-Mounts im Compose. Das NAS selbst unterscheidet nicht zwischen den Containern.
|
||
- Bind-Mounts mit `create_host_path: false`: Fehlt der NFS-Mount, startet der Container nicht, statt Medien auf die lokale Platte zu schreiben (wie bei Shinkan).
|
||
- Der Host-Pfad ist in `scripts/deploy.sh` fest an die Umgebung gebunden (`/srv/luf/$LUF_ENV/media`). Test kann nicht auf den Prod-Bestand zeigen. Das Skript prüft vor dem Build, dass der Pfad ein NFS-Mount ist, legt fehlende Unterordner an und macht nach dem Build eine Schreibprobe als `www-data`.
|
||
- Im Container liegen die Medien unter `/media/{originals,derived,public}`. Die Laravel-Dateisysteme (`config/filesystems.php`) zeigen in U0 darauf.
|
||
- Die CI-Tests mounten keine Medien (`Storage::fake()`).
|
||
- Datensicherung: Originale sind laut `11_Betrieb_Sicherheit_Datenschutz.md` kritisch (NAS und außer Haus). Snapshots und Replikation für `luf_media` sind Sache des NAS und noch nicht eingerichtet.
|
||
|
||
## Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht `sudo`)
|
||
|
||
1. `sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf`
|
||
2. `/etc/luf/test.env` und `/etc/luf/prod.env` aus [deploy/luf.env.example](../../deploy/luf.env.example) anlegen, `chmod 640`. Je eigener `APP_KEY` (`php artisan key:generate --show`) und eigenes DB-Passwort. Prod: `APP_ENV=production`, `APP_DEBUG=false`.
|
||
3. Auf dem Synology zwei Proxy-Einträge: Prod nach `192.168.2.144:3010`, Test nach `192.168.2.144:3011`.
|
||
4. In Gitea: Branch-Schutz für `main` (nur Pull Request, Freigabe nötig) und `develop`. Repository-Sichtbarkeit prüfen (siehe unten).
|
||
5. Backup (`borgmatic`) wieder grün, bevor produktiv deployt wird.
|
||
|
||
## Annahmen und offene Punkte
|
||
|
||
- **Repository-Zugriff der Runner [?]:** Die Workflows klonen `http://192.168.2.144:3000/Lars/laraundfelix.git` ohne Zugangsdaten, wie Shinkan. Ist das Repository privat und der Runner nicht angemeldet, schlägt der Clone fehl.
|
||
- **Gitea-Actions-Syntax [?]:** `needs:` und `github.sha` sind Standard, wurden aber auf dieser Gitea-Version nicht ausprobiert. `actions/checkout` wird bewusst nicht benutzt.
|
||
- **Laravel-Gerüst fehlt:** Das Dockerfile erwartet `composer.json`, `composer.lock`, `package.json` und `npm run build` im Repo-Root, außerdem die Standardroute `/up`.
|
||
- **Zeilenenden:** `.gitattributes` erzwingt LF für Skripte, weil lokal `core.autocrlf=true` gesetzt ist.
|
||
- **Öffentliche Uploads:** Der Web-Container hat kein `storage`-Volume. Werden Dateien über `storage:link` ausgeliefert, muss das mit U0 geklärt werden.
|
||
- **Reverse Proxy:** Laravel braucht vertrauenswürdige Proxys (`X-Forwarded-Proto`), sonst stimmen `https`-URLs nicht. In U0 konfigurieren.
|
||
- **Queue:** Datenbank-Queue (`QUEUE_CONNECTION=database`), kein Redis. Reicht für den Start.
|
||
- **Gate vor Prod:** Merge-Schutz ist eine Gitea-Einstellung und gehört nicht in die Workflows.
|
||
- **Umzug Test auf den Pi:** Werte oben in `deploy-test.yml` ändern (Label `ubuntu-latest`, Guard auf `raspberrypi5`/`aarch64`, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären.
|