Dateispeicher: S3 (Pro)

Einführung

Auf Basis des Datei-Management-Plugins wird ein zusätzlicher Dateispeichertyp unterstützt, der mit dem S3-Protokoll kompatibel ist. Jeder Objektspeicherdienst, der das S3-Protokoll unterstützt, kann problemlos angebunden werden, darunter Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO und Cloudflare R2. Dadurch werden Kompatibilität und Flexibilität der Speicherdienste weiter verbessert.

Funktionsmerkmale

Clientseitiger Upload: Der Datei-Upload muss nicht über den NocoBase-Server erfolgen, sondern wird direkt mit dem Dateispeicherdienst durchgeführt. Dadurch wird ein effizienteres und schnelleres Upload-Erlebnis ermöglicht.
Privater Zugriff: Beim Zugriff auf Dateien sind alle URLs signierte, temporär autorisierte Adressen, wodurch die Sicherheit und zeitliche Gültigkeit des Dateizugriffs gewährleistet werden.

Anwendungsfälle

Dateitabellenverwaltung: Zentrale Verwaltung und Speicherung aller hochgeladenen Dateien, mit Unterstützung für verschiedene Dateitypen und Speicherarten zur einfachen Kategorisierung und Suche.
Speicherung von Anhang-Feldern: Speicherung von in Formularen oder Datensätzen hochgeladenen Anhängen mit Unterstützung der Verknüpfung zu den jeweiligen Datensätzen.

Plugin-Konfiguration

Aktivieren Sie das Plugin plugin-file-storage-s3-pro
Klicken Sie auf "Setting-> FileManager", um die Einstellungen der Dateiverwaltung aufzurufen
Klicken Sie auf die Schaltfläche "Add new" und wählen Sie "S3 Pro"

Nach dem Öffnen der Einblendung sehen Sie ein Formular mit zahlreichen auszufüllenden Feldern. In den folgenden Abschnitten finden Sie die entsprechenden Parameterinformationen für die jeweiligen Dateidienste, die Sie korrekt in das Formular eintragen können.

Konfiguration der Anbieter

Amazon S3

Bucket erstellen

Öffnen Sie https://ap-southeast-1.console.aws.amazon.com/s3/home, um die S3-Konsole aufzurufen
Klicken Sie rechts auf die Schaltfläche "Create bucket"

Geben Sie den Bucket Name (Namen des Buckets) ein. Die übrigen Felder können auf den Standardeinstellungen belassen werden. Scrollen Sie zum unteren Seitenende und klicken Sie auf die Schaltfläche "Create", um die Erstellung abzuschließen.

CORS-Konfiguration

Öffnen Sie die Liste der Buckets und klicken Sie auf den soeben erstellten Bucket, um dessen Detailseite aufzurufen

Klicken Sie auf die Registerkarte "Permission" und scrollen Sie nach unten zum Abschnitt für die CORS-Konfiguration

Tragen Sie die folgende Konfiguration ein (Sie können die Konfiguration nach Bedarf detaillierter anpassen) und speichern Sie sie

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

AccessKey und SecretAccessKey abrufen

Klicken Sie oben rechts auf der Seite auf die Schaltfläche "Security credentials"

Scrollen Sie nach unten zum Abschnitt "Access Keys" und klicken Sie auf die Schaltfläche "Create Access Key".

Klicken Sie auf „Zustimmen“ (hier wird zur Demonstration das Hauptkonto verwendet; für Produktionsumgebungen wird die Verwendung von IAM empfohlen).

Speichern Sie den auf der Seite angezeigten Access key und Secret access key

Parameter abrufen und konfigurieren

AccessKey ID und AccessKey Secret sind die im vorherigen Schritt abgerufenen Werte. Tragen Sie sie sorgfältig ein
Öffnen Sie im Detailbereich des Buckets das Bedienfeld properties. Dort finden Sie den Namen des Buckets und die Informationen zur Region.

Öffentlicher Zugriff (optional)

Diese Konfiguration ist nicht erforderlich. Sie wird vorgenommen, wenn die hochgeladenen Dateien vollständig öffentlich zugänglich sein sollen

Öffnen Sie das Bedienfeld Permissions, scrollen Sie zu Object Ownership, klicken Sie auf „Bearbeiten“ und aktivieren Sie ACLs

Scrollen Sie zu Block public access, klicken Sie auf „Bearbeiten“ und wählen Sie die Einstellung, mit der die Steuerung durch ACLs erlaubt wird

Aktivieren Sie in NocoBase die Option Public access

Konfiguration von Vorschaubildern (optional)

Diese Konfiguration ist optional und wird verwendet, wenn die Größe oder Darstellung der Bildvorschau optimiert werden soll. Bitte beachten Sie, dass bei dieser Bereitstellung zusätzliche Kosten entstehen können. Einzelheiten entnehmen Sie bitte den entsprechenden Bedingungen von AWS.

Rufen Sie Dynamic Image Transformation for Amazon CloudFront auf.
Klicken Sie unten auf der Seite auf die Schaltfläche Launch in the AWS Console, um die Bereitstellung zu starten.
Führen Sie die Konfiguration gemäß den Anweisungen durch. 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. Geben Sie den Namen des zuvor erstellten Buckets ein.
2. Wenn Sie die Bereitstellung der Demo-UI auswählen, können Sie nach Abschluss der Bereitstellung die Bildverarbeitungsfunktionen über diese Oberfläche testen. Wählen Sie in der AWS-CloudFormation-Konsole Ihren Stack aus, wechseln Sie zur Registerkarte „Outputs“, suchen Sie den Wert des Schlüssels DemoUrl 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 nach Bedarf anpassen.
Warten Sie nach Abschluss der Konfiguration, bis sich der Bereitstellungsstatus in CREATE_COMPLETE geändert hat.
Beachten Sie bei der Konfiguration in NocoBase die folgenden Punkte:
1. Thumbnail rule: Geben Sie die Parameter für die Bildverarbeitung ein, z. B. ?width=100. Weitere Informationen finden Sie in der AWS-Dokumentation.
2. Access endpoint: Geben Sie den Wert von Outputs -> ApiEndpoint nach der Bereitstellung ein.
3. Full access URL style: Ignore muss aktiviert werden (da der Bucket-Name bereits bei der Konfiguration angegeben wurde und beim Zugriff nicht erneut benötigt wird).

Beispielkonfiguration