#Dateispeicher: S3 (Pro)

#Einführung

Aufbauend auf dem Dateiverwaltungs-Plugin wird in dieser Version die Unterstützung für Dateispeichertypen hinzugefügt, die mit dem S3-Protokoll kompatibel sind. Jeder Objektspeicherdienst, der das S3-Protokoll unterstützt, lässt sich nahtlos integrieren, wie z. B. Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 usw. Dies erhöht die Kompatibilität und Flexibilität der Speicherdienste erheblich.

#Funktionen

1. Client-Upload: Dateien werden direkt in den Speicherdienst hochgeladen, ohne den NocoBase-Server zu passieren. Dies ermöglicht ein effizienteres und schnelleres Hochladen.

2. Privater Zugriff: Alle Datei-URLs sind signierte, temporäre Autorisierungsadressen, die einen sicheren und zeitlich begrenzten Zugriff auf Dateien gewährleisten.

#Anwendungsfälle

1. Dateitabellen-Verwaltung: Zentrales Verwalten und Speichern aller hochgeladenen Dateien. Es werden verschiedene Dateitypen und Speichermethoden unterstützt, was die Klassifizierung und das Auffinden von Dateien erleichtert.

2. Speicherung von Anhangsfeldern: Dient der Datenspeicherung von Anhängen, die über Formulare oder Datensätze hochgeladen werden, und unterstützt die Verknüpfung mit spezifischen Datensätzen.

#Plugin-Konfiguration

1. Aktivieren Sie das Plugin plugin-file-storage-s3-pro.

2. Navigieren Sie zu "Einstellungen -> Dateimanager", um die Dateiverwaltungs-Einstellungen aufzurufen.

3. Klicken Sie auf die Schaltfläche "Neu hinzufügen" und wählen Sie "S3 Pro" aus.

4. Im daraufhin erscheinenden Pop-up-Fenster sehen Sie ein detailliertes Formular, das ausgefüllt werden muss. Die relevanten Parameter für Ihren Dateidienst finden Sie in der folgenden Dokumentation. Tragen Sie diese dann korrekt in das Formular ein.

#Konfiguration der Dienstanbieter

#Amazon S3

#Bucket-Erstellung

1. Besuchen Sie die Amazon S3 Konsole.

2. Klicken Sie auf die Schaltfläche "Bucket erstellen" auf der rechten Seite.

3. Geben Sie den Bucket-Namen ein, lassen Sie andere Felder auf den Standardeinstellungen, scrollen Sie zum Seitenende und klicken Sie auf die Schaltfläche "Erstellen", um den Vorgang abzuschließen.

#CORS-Konfiguration

1. Suchen und klicken Sie in der Bucket-Liste auf den soeben erstellten Bucket, um dessen Detailseite aufzurufen.

2. Navigieren Sie zur Registerkarte "Berechtigungen" und scrollen Sie nach unten zum Abschnitt für die CORS-Konfiguration.

3. Geben Sie die folgende Konfiguration ein (passen Sie diese bei Bedarf an) und speichern Sie sie.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

#Abrufen von AccessKey und SecretAccessKey

1. Klicken Sie auf die Schaltfläche "Sicherheitsanmeldeinformationen" in der oberen rechten Ecke.

2. Scrollen Sie zum Abschnitt "Zugriffsschlüssel" und klicken Sie auf die Schaltfläche "Zugriffsschlüssel erstellen".

3. Stimmen Sie den Bedingungen zu (für Produktionsumgebungen wird die Verwendung von IAM empfohlen).

4. Speichern Sie den angezeigten Access Key und Secret Access Key.

#Parameter abrufen und konfigurieren

1. Verwenden Sie die in den vorherigen Schritten abgerufenen Werte für AccessKey ID und AccessKey Secret. Bitte tragen Sie diese korrekt ein.

2. Rufen Sie das Eigenschaften-Panel des Buckets auf. Dort finden Sie den Bucket-Namen und die Region (Gebiet) Informationen.

#Öffentlicher Zugriff (Optional)

Dies ist eine optionale Konfiguration. Nehmen Sie diese vor, wenn Sie hochgeladene Dateien vollständig öffentlich zugänglich machen möchten.

1. Navigieren Sie im Berechtigungs-Panel zum Abschnitt "Objektbesitz", klicken Sie auf "Bearbeiten" und aktivieren Sie ACLs.

2. Scrollen Sie zu "Öffentlichen Zugriff blockieren", klicken Sie auf "Bearbeiten" und stellen Sie die Option so ein, dass ACLs die Kontrolle erlauben.

3. Aktivieren Sie in NocoBase die Option "Öffentlicher Zugriff".

#Miniaturansicht-Konfiguration (Optional)

Diese Konfiguration ist optional und wird verwendet, wenn Sie die Größe oder den Effekt der Bildvorschau optimieren möchten. Bitte beachten Sie, dass diese Bereitstellung zusätzliche Kosten verursachen kann. Detaillierte Informationen zu den Kosten finden Sie in den entsprechenden AWS-Bedingungen.

1. Besuchen Sie Dynamic Image Transformation for Amazon CloudFront.

2. Klicken Sie unten auf der Seite auf die Schaltfläche Launch in the AWS Console, um die Bereitstellung zu starten.

3. Folgen Sie den Anweisungen, um die Konfiguration abzuschließen. Die folgenden Optionen erfordern besondere Aufmerksamkeit:
   1. Beim Erstellen des Stacks müssen Sie den Namen eines Amazon S3 Buckets angeben, der die Quellbilder enthält. Bitte geben Sie den zuvor von Ihnen erstellten Bucket-Namen ein.
   2. Wenn Sie sich für die Bereitstellung der Demo-Benutzeroberfläche entschieden haben, können Sie nach der Bereitstellung die Bildverarbeitungsfunktionen über diese Oberfläche testen. Wählen Sie in der AWS CloudFormation-Konsole Ihren Stack aus, wechseln Sie zur Registerkarte "Ausgaben", suchen Sie den Wert, der dem Schlüssel DemoUrl entspricht, und klicken Sie auf den Link, um die Demo-Oberfläche zu öffnen.
   3. Diese Lösung verwendet die sharp Node.js-Bibliothek zur effizienten Bildverarbeitung. Sie können den Quellcode aus dem GitHub-Repository herunterladen und bei Bedarf anpassen.

4. Sobald die Konfiguration abgeschlossen ist, warten Sie, bis der Bereitstellungsstatus zu CREATE_COMPLETE wechselt.

5. Beachten Sie in der NocoBase-Konfiguration die folgenden Punkte:

   1. Thumbnail rule: Geben Sie die relevanten Bildverarbeitungsparameter ein, z. B. ?width=100. Details finden Sie in der AWS-Dokumentation.
   2. Access endpoint: Geben Sie den Wert aus Outputs -> ApiEndpoint nach der Bereitstellung ein.
   3. Full access URL style: Wählen Sie Ignorieren aus (da der Bucket-Name bereits in der Konfiguration angegeben wurde und beim Zugriff nicht mehr benötigt wird).

#Konfigurationsbeispiel

#Alibaba Cloud OSS

#Bucket-Erstellung

1. Öffnen Sie die OSS Konsole.

2. Wählen Sie im linken Menü "Buckets" aus und klicken Sie dann auf die Schaltfläche "Bucket erstellen", um einen Bucket zu erstellen.

3. Füllen Sie die Bucket-Details aus und klicken Sie auf die Schaltfläche "Erstellen".

   1. Bucket-Name: Wählen Sie einen Namen, der Ihren Geschäftsanforderungen entspricht.
   2. Region: Wählen Sie die für Ihre Benutzer nächstgelegene Region aus.
   3. Andere Einstellungen können Standard bleiben oder bei Bedarf angepasst werden.

#CORS-Konfiguration

1. Navigieren Sie zur Detailseite des soeben erstellten Buckets.

2. Klicken Sie im mittleren Menü auf "Inhaltssicherheit -> CORS".

3. Klicken Sie auf die Schaltfläche "Regel erstellen", füllen Sie die Felder aus, scrollen Sie nach unten und klicken Sie auf "OK". Sie können sich am folgenden Screenshot orientieren oder detailliertere Einstellungen vornehmen.

#Abrufen von AccessKey und SecretAccessKey

1. Klicken Sie oben rechts unter Ihrem Konto-Avatar auf "AccessKey".

2. Zu Demonstrationszwecken erstellen wir einen AccessKey mit dem Hauptkonto. In einer Produktionsumgebung wird jedoch empfohlen, RAM für die Erstellung des AccessKeys zu verwenden. Anweisungen dazu finden Sie in der Alibaba Cloud-Dokumentation.

3. Klicken Sie auf die Schaltfläche "AccessKey erstellen".

4. Führen Sie die Kontoverifizierung durch.

5. Speichern Sie den angezeigten Access Key und Secret Access Key.

#Parameter abrufen und konfigurieren

1. Verwenden Sie die in den vorherigen Schritten erhaltenen Werte für AccessKey ID und AccessKey Secret.

2. Rufen Sie die Bucket-Detailseite auf, um den Bucket-Namen zu erhalten.

3. Scrollen Sie nach unten, um die Region zu erhalten (das nachfolgende ".aliyuncs.com" ist nicht erforderlich).

4. Rufen Sie die Endpoint-Adresse ab und fügen Sie beim Eintragen in NocoBase das Präfix https:// hinzu.

#Miniaturansicht-Konfiguration (Optional)

Diese Konfiguration ist optional und sollte nur verwendet werden, wenn die Größe oder der Effekt der Bildvorschau optimiert werden soll.

1. Geben Sie die relevanten Parameter für die Thumbnail rule ein. Spezifische Parametereinstellungen finden Sie in der Alibaba Cloud-Dokumentation zur Bildverarbeitung.

2. Die Einstellungen für Full upload URL style und Full access URL style sollten identisch sein.

#Konfigurationsbeispiel

#MinIO

#Bucket-Erstellung

1. Klicken Sie im linken Menü auf Buckets -> Klicken Sie auf Bucket erstellen, um die Erstellungsseite zu öffnen.
2. Geben Sie den Bucket-Namen ein und klicken Sie dann auf die Schaltfläche Speichern.

#Abrufen von AccessKey und SecretAccessKey

1. Navigieren Sie zu Zugriffsschlüssel -> Klicken Sie auf die Schaltfläche Zugriffsschlüssel erstellen, um die Erstellungsseite zu öffnen.

2. Klicken Sie auf die Schaltfläche Speichern.

3. Speichern Sie den Access Key und den Secret Key aus dem Pop-up-Fenster für die spätere Konfiguration.

#Parameterkonfiguration

1. Gehen Sie in NocoBase zur Seite Dateimanager.

2. Klicken Sie auf die Schaltfläche Neu hinzufügen und wählen Sie S3 Pro aus.

3. Füllen Sie das Formular aus:

   • AccessKey ID und AccessKey Secret: Verwenden Sie die im vorherigen Schritt gespeicherten Werte.
   • Region: Ein privat bereitgestelltes MinIO hat kein Region-Konzept; Sie können es auf "auto" setzen.
   • Endpoint: Geben Sie den Domänennamen oder die IP-Adresse Ihres bereitgestellten Dienstes ein.
   • Stellen Sie den Full access URL style auf Path-Style ein.

#Konfigurationsbeispiel

#Tencent COS

Sie können sich an den Konfigurationen der oben genannten Dateidienste orientieren; die Logik ist ähnlich.

#Konfigurationsbeispiel

#Cloudflare R2

Sie können sich an den Konfigurationen der oben genannten Dateidienste orientieren; die Logik ist ähnlich.

#Konfigurationsbeispiel

#Benutzerhandbuch

Beachten Sie die Dokumentation des Dateimanager-Plugins.