5.9 KiB
LUF – Deployment (Stand 2026-11-15)
Abgeleitet aus dem Shinkan-Verfahren, siehe 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 (/upund 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.shfest 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 alswww-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.mdkritisch (NAS und außer Haus). Snapshots und Replikation fürluf_mediasind Sache des NAS und noch nicht eingerichtet.
Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht sudo)
sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf/etc/luf/test.envund/etc/luf/prod.envaus deploy/luf.env.example anlegen,chmod 640. Je eigenerAPP_KEY(php artisan key:generate --show) und eigenes DB-Passwort. Prod:APP_ENV=production,APP_DEBUG=false.- Auf dem Synology zwei Proxy-Einträge: Prod nach
192.168.2.144:3010, Test nach192.168.2.144:3011. - In Gitea: Branch-Schutz für
main(nur Pull Request, Freigabe nötig) unddevelop. Repository-Sichtbarkeit prüfen (siehe unten). - 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.gitohne Zugangsdaten, wie Shinkan. Ist das Repository privat und der Runner nicht angemeldet, schlägt der Clone fehl. - Gitea-Actions-Syntax [?]:
needs:undgithub.shasind Standard, wurden aber auf dieser Gitea-Version nicht ausprobiert.actions/checkoutwird bewusst nicht benutzt. - Laravel-Gerüst fehlt: Das Dockerfile erwartet
composer.json,composer.lock,package.jsonundnpm run buildim Repo-Root, außerdem die Standardroute/up. - Zeilenenden:
.gitattributeserzwingt LF für Skripte, weil lokalcore.autocrlf=truegesetzt ist. - Öffentliche Uploads: Der Web-Container hat kein
storage-Volume. Werden Dateien überstorage:linkausgeliefert, muss das mit U0 geklärt werden. - Reverse Proxy: Laravel braucht vertrauenswürdige Proxys (
X-Forwarded-Proto), sonst stimmenhttps-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 (Labelubuntu-latest, Guard aufraspberrypi5/aarch64, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären.