S3-Speicher für Hintergrundaufgaben-Protokolle

Übersicht

Hintergrundaufgaben-Protokolle werden standardmäßig lokal in ./files/logs/tasks/ gespeichert. Um S3-kompatiblen Speicher zu verwenden, konfigurieren Sie die Parameter in der Konfigurationsdatei.

Erforderlich für fehlertolerante Konfigurationen

In fehlertoleranten Umgebungen laufen Hintergrundaufgaben auf jedem Anwendungsserver-Knoten: Ein Knoten kann N Aufgaben ausführen, ein anderer Knoten seine eigenen. Die Registerkarte Hintergrundaufgaben in der Weboberfläche zeigt nur Protokolle vom aktuellen Knoten. Um Protokolle von Aufgaben anzuzeigen, die auf einem anderen Knoten ausgeführt wurden, müssen Sie sich direkt mit diesem Knoten verbinden. Mit S3-Speicher sind alle Protokolle von einem einzigen Speicher aus verfügbar, und Sie können sie in der Weboberfläche anzeigen, ohne zwischen Knoten wechseln zu müssen.

Konfigurationsdatei

S3-Parameter werden in .env.local (oder .env in Docker) festgelegt, die sich hier befinden:

• Linux — /var/www/.env.local
• Windows Server — C:\inetpub\wwwroot\passwork\.env.local
• Docker — /<passwork>/.env

info

Wenn die Datei nicht existiert, erstellen Sie sie.

Parameter

Parameter	Beschreibung
APP_FILES_SOURCE	Speicherquelle: files.storage.local (Standard) oder files.storage.aws (S3).
S3_REGION	Bucket-Region.
S3_BUCKET	Bucket-Name.
S3_STORAGE_PREFIX	Pfadpräfix innerhalb des Buckets (z. B. passwork-logs).
S3_STORAGE_KEY	S3-Zugriffsschlüssel.
S3_STORAGE_SECRET	S3-Geheimschlüssel.
S3_ENDPOINT	Speicher-Endpunkt. Für AWS S3 weglassen.
S3_USE_PATH_STYLE_ENDPOINT	Pfadstil-Adressierung: 0 — Virtual-Hosted-Stil, 1 — Pfadstil (verwenden Sie 1 für MinIO).

Protokolle werden gespeichert unter — {S3_STORAGE_PREFIX}logs/tasks/YYYY/MM/DD/task-{taskId}.log

Beispiele

AWS

shell

APP_FILES_SOURCE=files.storage.aws
S3_REGION=us-east-1
S3_BUCKET=pwk
S3_STORAGE_PREFIX=passwork-logs
S3_STORAGE_KEY=AKIAIOSFODNN7EXAMPLE
S3_STORAGE_SECRET=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
S3_USE_PATH_STYLE_ENDPOINT=0

MinIO

shell

APP_FILES_SOURCE=files.storage.aws
S3_REGION=us-east-1
S3_BUCKET=pwk
S3_STORAGE_PREFIX=passwork-logs
S3_ENDPOINT=https://minio.example.com
S3_USE_PATH_STYLE_ENDPOINT=1
S3_STORAGE_KEY=webapp-logs
S3_STORAGE_SECRET=1GV6qaFpMYR11zs0VDEy

DigitalOcean Spaces

shell

APP_FILES_SOURCE=files.storage.aws
S3_REGION=nyc3
S3_BUCKET=pwk
S3_STORAGE_PREFIX=passwork-logs
S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
S3_USE_PATH_STYLE_ENDPOINT=0
S3_STORAGE_KEY=your-spaces-access-key
S3_STORAGE_SECRET=your-spaces-secret-key

Google Cloud Storage

shell

APP_FILES_SOURCE=files.storage.aws
S3_REGION=us-east1
S3_BUCKET=pwk
S3_STORAGE_PREFIX=passwork-logs
S3_ENDPOINT=https://storage.googleapis.com
S3_USE_PATH_STYLE_ENDPOINT=0
S3_STORAGE_KEY=your-gcs-hmac-access-id
S3_STORAGE_SECRET=your-gcs-hmac-secret

Nach der Änderung der Parameter starten Sie den PHP-FPM-Dienst oder den Docker-Container neu:

DEB

systemctl restart php8.3-fpm

RPM

systemctl restart php-fpm

Docker

docker restart passwork_php

PowerShell

Restart-Service -Name "W3SVC"