Files
laraundfelix/docs/betrieb/DEPLOYMENT.md
T

5.9 KiB
Raw Blame History

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 (/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 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.