Binde die Medien im Container unter demselben Pfad wie auf dem Host ein.
Deploy Test / test (push) Successful in 11s
Deploy Test / deploy (push) Successful in 15s

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-11-15 08:43:42 +01:00
1 parent 2ded4b7fad
commit 463851d402
6 files changed
+21 -15

No files matched your search

+1 -1
View File
@@ -64,7 +64,7 @@ AWS_USE_PATH_STYLE_ENDPOINT=false
VITE_APP_NAME="${APP_NAME}"
# Im Container: /media/public, /media/derived, /media/originals. Lokal: Standard unter storage/.
# Leer lassen. Lokal gilt dann storage/. Im Container setzt Compose den Host-Mount (/srv/luf/<env>/media/...).
MEDIA_PUBLIC_PATH=
MEDIA_DERIVED_PATH=
MEDIA_ORIGINALS_PATH=
+1 -1
View File
@@ -49,7 +49,7 @@ ## Server und Umgebungen
## Medien
- Medien liegen auf dem NAS (NFS), je Umgebung eigener Bestand: Test `luf_media_dev`, Prod `luf_media`. Mountpunkte `/srv/luf/test/media` und `/srv/luf/prod/media`. Die Umgebungen dürfen nie auf den Bestand der anderen zeigen.
- Im Container: `/media/originals`, `/media/derived`, `/media/public`. **Der Web-Prozess hat keinen Zugriff auf `originals/`** und liest `derived/` und `public/` nur. Nur die Hintergrundverarbeitung (`queue`) schreibt. Diese Trennung (Architektur 03 und 08) nicht aufweichen, auch nicht „vorübergehend“.
- Im Container gilt derselbe Pfad wie auf dem Host (`/srv/luf/test/media` bzw. `/srv/luf/prod/media`, Unterordner `originals/`, `derived/`, `public/`). **Der Web-Prozess hat keinen Zugriff auf `originals/`** und liest `derived/` und `public/` nur. Nur die Hintergrundverarbeitung (`queue`) schreibt. Diese Trennung (Architektur 03 und 08) nicht aufweichen, auch nicht „vorübergehend“.
- Private Medien werden nie über einen statischen öffentlichen Pfad ausgeliefert, sondern nur nach Berechtigungsentscheidung über kurzlebige Signaturen.
- Mounts am Server (fstab) und NFS-Freigaben auf dem NAS ändert Lars. Claude liefert die Zeilen, schreibt sie aber nicht.
+1 -3
View File
@@ -24,6 +24,4 @@ MAIL_MAILER=log
MAIL_FROM_ADDRESS="noreply@example.invalid"
MAIL_FROM_NAME="${APP_NAME}"
MEDIA_PUBLIC_PATH=/media/public
MEDIA_DERIVED_PATH=/media/derived
MEDIA_ORIGINALS_PATH=/media/originals
# Medienpfade setzt Compose auf den Host-Mount (/srv/luf/<env>/media/...). Hier nichts eintragen.
+13 -6
View File
@@ -2,7 +2,8 @@
# die das Deploy-Skript setzt (scripts/deploy.sh). Es gibt keine festen Host-Ports außer dem Web-Port.
#
# Pflicht-Variablen (vom Skript exportiert): LUF_ENV (test|prod), LUF_TAG, LUF_ENV_FILE, LUF_WEB_PORT
# Medien: LUF_MEDIA_HOST (setzt das Deploy-Skript auf /srv/luf/<env>/media, NFS-Mount vom NAS) mit den Unterordnern
# Medien: LUF_MEDIA_HOST (setzt das Deploy-Skript auf /srv/luf/<env>/media, NFS-Mount vom NAS).
# Im Container gilt derselbe Pfad wie auf dem Host. Unterordner:
# originals/ nur queue (lesen+schreiben); der Web-Prozess (app) hat KEINEN Zugriff (Architektur 03/08)
# derived/ queue schreibt, app liest nur (private Ableitungen, Auslieferung nur über Signatur)
# public/ queue schreibt, app liest nur (bewusst öffentliche Medien)
@@ -41,17 +42,20 @@ services:
environment:
DB_HOST: db
DB_PORT: "5432"
MEDIA_PUBLIC_PATH: ${LUF_MEDIA_HOST:?}/public
MEDIA_DERIVED_PATH: ${LUF_MEDIA_HOST:?}/derived
MEDIA_ORIGINALS_PATH: ${LUF_MEDIA_HOST:?}/originals
volumes:
- storage-data:/var/www/html/storage
- type: bind
source: ${LUF_MEDIA_HOST:?}/derived
target: /media/derived
target: ${LUF_MEDIA_HOST:?}/derived
read_only: true
bind:
create_host_path: false
- type: bind
source: ${LUF_MEDIA_HOST:?}/public
target: /media/public
target: ${LUF_MEDIA_HOST:?}/public
read_only: true
bind:
create_host_path: false
@@ -80,21 +84,24 @@ services:
environment:
DB_HOST: db
DB_PORT: "5432"
MEDIA_PUBLIC_PATH: ${LUF_MEDIA_HOST:?}/public
MEDIA_DERIVED_PATH: ${LUF_MEDIA_HOST:?}/derived
MEDIA_ORIGINALS_PATH: ${LUF_MEDIA_HOST:?}/originals
volumes:
- storage-data:/var/www/html/storage
- type: bind
source: ${LUF_MEDIA_HOST:?}/originals
target: /media/originals
target: ${LUF_MEDIA_HOST:?}/originals
bind:
create_host_path: false
- type: bind
source: ${LUF_MEDIA_HOST:?}/derived
target: /media/derived
target: ${LUF_MEDIA_HOST:?}/derived
bind:
create_host_path: false
- type: bind
source: ${LUF_MEDIA_HOST:?}/public
target: /media/public
target: ${LUF_MEDIA_HOST:?}/public
bind:
create_host_path: false
depends_on:
+2 -2
View File
@@ -50,7 +50,7 @@ ## Medien-Ablage auf dem NAS
- 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.
- Im Container ist der Pfad derselbe wie auf dem Host. Compose hängt die Unterordner an genau diese Stelle und setzt `MEDIA_PUBLIC_PATH`, `MEDIA_DERIVED_PATH` und `MEDIA_ORIGINALS_PATH` darauf. Ein abweichender Wert in der Env-Datei wird damit überstimmt.
- 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.
@@ -68,7 +68,7 @@ ## Annahmen und offene Punkte
- **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:** `composer.json`, `composer.lock`, `package.json` und `package-lock.json` liegen im Root. Die Health-Route ist `/up`. Das Image veröffentlicht die Filament-Assets beim Bau (`php artisan filament:assets`) und baut das Frontend mit `npm run build`.
- **Zeilenenden:** `.gitattributes` erzwingt LF für Skripte, weil lokal `core.autocrlf=true` gesetzt ist.
- **Öffentliche CMS-Bilder:** Der Web-Prozess schreibt nicht nach `/media/public`. Ein Upload liegt zuerst auf dem beschreibbaren Storage-Volume (`cms_incoming`). Die Queue kopiert nach `/media/public`. Ausgeliefert wird die Datei über die Anwendung unter `/medien/…`, zuerst aus dem öffentlichen Medienpfad, ersatzweise aus dem Eingang. `storage:link` wird dafür nicht gebraucht. Die Env-Datei braucht `MEDIA_PUBLIC_PATH`, `MEDIA_DERIVED_PATH` und `MEDIA_ORIGINALS_PATH` (siehe `deploy/luf.env.example`).
- **Öffentliche CMS-Bilder:** Der Web-Prozess schreibt nicht nach `public/`. Ein Upload liegt zuerst auf dem beschreibbaren Storage-Volume (`cms_incoming`). Die Queue kopiert nach `public/` auf dem Medienpfad. Ausgeliefert wird die Datei über die Anwendung unter `/medien/…`, zuerst aus dem öffentlichen Medienpfad, ersatzweise aus dem Eingang. `storage:link` wird dafür nicht gebraucht.
- **Reverse Proxy:** Die Anwendung vertraut weitergeleiteten Proxy-Kopfzeilen. Nginx reicht `X-Forwarded-Proto`, `X-Forwarded-Host`, `X-Forwarded-Port` und `X-Forwarded-For` an PHP weiter. Der Proxy vor dem Container muss `X-Forwarded-Proto` setzen, damit Adressen `https` bleiben.
- **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.
+3 -2
View File
@@ -104,8 +104,9 @@ deploy() {
echo "=== LUF $LUF_ENV: Build $LUF_TAG ==="
dc build app web || return 1
# Schreibprobe als www-data (echte UID im Container) auf den Medienordnern der Hintergrundverarbeitung.
dc run --rm --no-deps -T queue sh -c 'for d in originals derived public; do f=/media/$d/.write-test-$$; touch "$f" && rm "$f" || exit 1; done' || { echo "✗ Schreibprobe auf /media fehlgeschlagen (NFS-Rechte/Squash auf dem NAS prüfen)"; return 1; }
echo "✓ Schreibprobe auf /media bestanden"
dc run --rm --no-deps -T queue sh -c 'for f in "$MEDIA_ORIGINALS_PATH" "$MEDIA_DERIVED_PATH" "$MEDIA_PUBLIC_PATH"; do t="$f/.write-test-$$"; touch "$t" && rm "$t" || exit 1; done' \
|| { echo "✗ Schreibprobe auf $LUF_MEDIA_HOST fehlgeschlagen (NFS-Rechte/Squash auf dem NAS prüfen)"; return 1; }
echo "✓ Schreibprobe auf $LUF_MEDIA_HOST bestanden"
dc up -d db || return 1
wait_for_db || return 1
echo "=== Migrationen ==="