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:

EinstellungBeschreibung
EndpointDie S3-API-URL. Bei AWS S3 optional, der Endpoint wird dann aus der Region abgeleitet.
Access KeyAuthentifizierungs-Key-ID
Secret KeyAuthentifizierungs-Secret
Bucket-NameDer Name des Speicher-Buckets. Relution legt den Bucket nicht selbst an, er muss bereits vorhanden sein und wird nur von dieser Relution-Instanz genutzt.
RegionRegion 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

  1. Die neuesten Images laden:

    docker compose pull
    
  2. Die Container starten oder neu starten:

    docker compose up -d
    
  3. Relution 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 Wert 0 schaltet 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).


Wichtige Hinweise

Nicht umkehrbarer Prozess: Ab Relution 26.0.0 kann die Migration zu Objektspeicher nicht rückgängig gemacht werden.
Backup: Sicherstellen, dass der Objektspeicher-Bucket in die Backup-Routine eingebunden ist. Ohne diese Daten kann der Serverbetrieb und die Geräteverwaltung nicht gewährleistet werden. Die Datenbank muss weiterhin gesichert werden, da sie kleine Dateien, Zertifikate und Schlüssel enthält.

Wie hilfreich war dieser Artikel?