S3 Primary Object Storage #

Mit dieser App legt owncloud.online die Inhalte aller Dateien in einem S3-Bucket ab statt im Datenverzeichnis. Dateinamen, Freigaben und Rechte bleiben in der Datenbank. Die App ist für Administratoren gedacht, die eine neue Instanz auf Amazon S3 oder einem S3-kompatiblen Objektspeicher wie Ceph RGW, MinIO oder Scality aufbauen. Anwender merken davon nichts.

Soll S3 nur als zusätzlicher Ordner erscheinen, ist External Storage: S3 die passende App.

Voraussetzungen #

Installation #

1. App installieren. market:install schaltet sie dabei ein:

   bashKopieren

   sudo -u www-data php8.4 occ market:install files_primary_s3
   
   # nur nötig, wenn die App schon vorhanden, aber ausgeschaltet ist
   sudo -u www-data php8.4 occ app:enable files_primary_s3
   

2. Den Bucket mit den Werkzeugen des Anbieters anlegen und dort die Versionierung einschalten. Region, Verschlüsselung, Lebenszyklus-Regeln und CORS legen Sie dabei selbst fest.

3. Den Eintrag objectstore in config/config.php ergänzen, siehe Einrichtung.

4. Ohne OPcache verwendet schon die nächste Anfrage den neuen Speicher. Läuft PHP-FPM mit OPcache, laden Sie es einmal neu:

   bashKopieren

   sudo systemctl reload php8.4-fpm
   

5. Prüfen: occ s3:list <bucket> aufrufen, eine Datei hochladen und den Befehl wiederholen. Die neue Datei erscheint als Objekt urn:oid:<Datei-ID>.

Einrichtung #

Die App hat keine eigene Einstellungsseite. Eingerichtet wird sie in config/config.php:

'objectstore' => [
    'class' => 'OCA\\Files_Primary_S3\\S3Storage',
    'arguments' => [
        'bucket' => 'oco-daten',
        'options' => [
            'version' => 'latest',
            'region' => 'eu-central-1',
            'endpoint' => 'https://s3.example.com',
            'use_path_style_endpoint' => true,
            'credentials' => [
                'key' => '<ACCESS_KEY>',
                'secret' => '<SECRET_KEY>',
            ],
        ],
        // optional
        'serversideencryption' => 'AES256',
    ],
],

Große Dateien lädt die App in Teilen hoch (Multipart-Upload). Damit gehen auch Dateien über 5 GB.

Befehle #

s3:create-bucket fragt vor dem Anlegen nach. --accept-warning überspringt die Frage, --update-configuration schaltet die Versionierung auch für einen schon vorhandenen Bucket ein.

sudo -u www-data php8.4 occ s3:list oco-daten
sudo -u www-data php8.4 occ s3:list oco-daten urn:oid:42

Nutzung #

Für Anwender ändert sich nichts. Weboberfläche, Desktop-Client, mobile Apps und WebDAV arbeiten wie gewohnt. Ältere Stände einer Datei stammen aus der Versionierung des Buckets und erscheinen wie sonst im Reiter Versionen.

Grenzen und Hinweise #

• Verschlüsselung: Die Verschlüsselung von owncloud.online (App encryption) passt nicht zum primären Objektspeicher. Unter Einstellungen → Administration → Verschlüsselung steht dann „Speicherverschlüsselung ist mit S3 Object Storage nicht kompatibel.“ und das Einschalten ist gesperrt. Verschlüsseln Sie stattdessen im Bucket mit serversideencryption.
• Versionen: Versionen entstehen nur, wenn die Versionierung im Bucket eingeschaltet ist. owncloud.online löscht im Bucket keine älteren Versionen. Auch endgültig gelöschte Dateien bleiben dort als ältere Version liegen. Eine Lebenszyklus-Regel beim Anbieter, die ältere Versionen nach einer Frist entfernt, hält den Bucket klein.
• Datensicherung: Datenbank und Bucket gehören zusammen. Sichern Sie beide zum selben Zeitpunkt oder nutzen Sie Replikation und Versionierung des Anbieters. Siehe Backups und Updates.
• Platzbedarf: du auf dem Datenverzeichnis zeigt fast nichts mehr. Den belegten Platz nennt der Anbieter.
• Externe Speicher: Einen Objektspeicher als primären Speicher und zusätzlich eingebundene externe Speicher können Sie nebeneinander betreiben. Den Vergleich zeigt Externe Speicher.

Fehlersuche #

Die vollständige Fehlermeldung des S3-Clients steht im Serverprotokoll, siehe Serverprotokoll und Fehlermeldungen.