diff --git a/.env.example b/.env.example index 6c1e489..5c4c35e 100644 --- a/.env.example +++ b/.env.example @@ -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//media/...). MEDIA_PUBLIC_PATH= MEDIA_DERIVED_PATH= MEDIA_ORIGINALS_PATH= diff --git a/CLAUDE.md b/CLAUDE.md index ca1e528..12c5bdf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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. diff --git a/deploy/luf.env.example b/deploy/luf.env.example index 6a3add1..8fe7760 100644 --- a/deploy/luf.env.example +++ b/deploy/luf.env.example @@ -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//media/...). Hier nichts eintragen. diff --git a/docker-compose.yml b/docker-compose.yml index b8b34d0..6c3123d 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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//media, NFS-Mount vom NAS) mit den Unterordnern +# Medien: LUF_MEDIA_HOST (setzt das Deploy-Skript auf /srv/luf//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: diff --git a/docs/betrieb/DEPLOYMENT.md b/docs/betrieb/DEPLOYMENT.md index e70925b..f82c141 100644 --- a/docs/betrieb/DEPLOYMENT.md +++ b/docs/betrieb/DEPLOYMENT.md @@ -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. diff --git a/scripts/deploy.sh b/scripts/deploy.sh index 02875fe..dc14d10 100644 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -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 ==="