Objektspeicher verbinden
Nachdem ein S3-kompatibles Objektspeicher-Backend bereitsteht - egal ob selbst-gehostet oder cloud-basiert - muss Relution für dessen Verwendung konfiguriert werden.
Voraussetzungen
Die folgenden Informationen vom Objektspeicher-Anbieter werden benötigt:
| Einstellung | Beschreibung |
|---|---|
| Endpoint | Die S3-API-URL. Bei AWS S3 optional, der Endpoint wird dann aus der Region abgeleitet. |
| Access Key | Authentifizierungs-Key-ID |
| Secret Key | Authentifizierungs-Secret |
| Bucket-Name | Der Name des Speicher-Buckets. Relution legt den Bucket nicht selbst an, er muss bereits vorhanden sein und wird nur von dieser Relution-Instanz genutzt. |
| Region | Region des Buckets (optional, Standard eu-west-1). Bei AWS S3 die tatsächliche Bucket-Region, z. B. eu-central-1. |
Bleiben Access Key und Secret Key leer, meldet sich Relution über das Instance-Profile an. Das ist nur beim Betrieb auf AWS EC2 mit zugewiesener IAM-Rolle sinnvoll.
Die nachfolgenden Konfigurationsbeispiele verwenden Beispielwerte, die zu SeaweedFS einrichten → passen. Bei Verwendung eines anderen Backends oder Anbieters diese entsprechend anpassen.
Konfiguration
Eine der beiden folgenden Optionen wählen. Beide erreichen dasselbe Ergebnis.
Option A: Verwendung von application.yml
Folgendes zur eigenen application.yml hinzufügen:
relution:
storage:
resourceStorageType: S3
s3:
customEndpoint: http://seaweedfs:8333
accessKey: %IHR-ACCESS-KEY%
secretKey: %IHR-SECRET-KEY%
bucketName: relution
region: eu-west-1 # optional, Standard: eu-west-1
Option B: Verwendung von Umgebungsvariablen
Diese Umgebungsvariablen zum relution Service in der eigenen compose.yaml hinzufügen:
services:
relution:
environment:
- RELUTION_STORAGE_RESOURCESTORAGETYPE=S3
- RELUTION_STORAGE_S3_CUSTOMENDPOINT=http://seaweedfs:8333
- RELUTION_STORAGE_S3_ACCESSKEY=%IHR-ACCESS-KEY%
- RELUTION_STORAGE_S3_SECRETKEY=%IHR-SECRET-KEY%
- RELUTION_STORAGE_S3_BUCKETNAME=relution
- RELUTION_STORAGE_S3_REGION=eu-west-1 # optional, Standard: eu-west-1
Die Werte stehen ohne Anführungszeichen, da Docker Compose Anführungszeichen in dieser Listenform als Teil des Werts übernimmt. Bestehende Einträge unter environment: (z. B. TZ) bleiben erhalten.
Soll der Objektspeicher mit einem kundenseitigen Schlüssel verschlüsselt werden, muss das vor dem ersten Start geschehen: Serverseitige Verschlüsselung (SSE-C) →
Services starten
Die neuesten Images laden:
docker compose pullDie Container starten oder neu starten:
docker compose up -dRelution beginnt automatisch mit der Migration von Inhalten aus der
resource-Datenbanktabelle in den Objektspeicher-Bucket.
Nicht alle Inhalte wandern in den Bucket:
- Dateien bis 512 KB bleiben in der Datenbank (
relution.storage.s3.smallFileThreshold, der Wert0schaltet diese Regel ab). - Zertifikate und private Schlüssel bleiben immer verschlüsselt in der Datenbank.
Die erste Migration startet beim ersten Start mit Objektspeicher. Ressourcen, die danach noch in der Datenbank liegen, verarbeitet Relution täglich um 3:00 Uhr (relution.storage.s3.resourceMigrationSchedule). Fehlgeschlagene Übertragungen werden nach 5 Minuten erneut versucht.
Fortschritt überwachen
Den Migrationsfortschritt in den Logs beobachten:
docker logs -f relution
Jede in den Objektspeicher übertragene Datei erscheint als Saving file <UUID> in S3 at key <Key>, große Dateien als Saving large file <UUID> in S3 via multipart upload. Eine Gesamtzahl oder Prozentangabe gibt Relution mit dem Standard-Loglevel nicht aus. Fehlgeschlagene Übertragungen erscheinen als Scheduling retry attempt for resource migration of <UUID> und werden später erneut versucht. Ressourcen, die sich nicht migrieren lassen, erscheinen als Won't migrate resource <UUID>.
Zusätzlich lässt sich überprüfen, ob Dateien erstellt werden, indem das Objektspeicher-Backend geprüft wird (z. B. über die SeaweedFS-Web-UI oder die Konsole des Cloud-Anbieters).