Remote Storage konfigurieren

Das Remote-Speichermodul bietet die Möglichkeit, Mediendateien zu speichern und Importe und Exporte mithilfe eines Speicherdienstes wie AWS S3 in einem beständigen Remote-Speicher-Container zu planen. Standardmäßig speichert die Adobe Commerce-Anwendung Mediendateien im selben Dateisystem, das die Anwendung enthält. Dies ist bei komplexen Konfigurationen mit mehreren Servern ineffizient und kann bei der Freigabe von Ressourcen zu einer beeinträchtigten Leistung führen. Mit dem Remote-Speichermodul können Sie Mediendateien im Ordner "pub/media"speichern und Dateien im Ordner "var"des Remote-Objektspeichers importieren/exportieren, um von der serverseitigen Bildgröße zu profitieren.

INFO
Remote-Speicher ist nur für Commerce Version 2.4.2 und höher verfügbar. Siehe Versionshinweise zu 2.4.2.
INFO
Das Remote-Speichermodul bietet in Adobe Commerce in der Cloud-Infrastruktur begrenzte Unterstützung. Adobe kann keine vollständige Fehlerbehebung für den Speicheradapterdienst von Drittanbietern durchführen. Eine Anleitung zur Implementierung von Remote-Speicher für Cloud-Projekte finden Sie unter Konfigurieren von Remote-Speicher für Commerce in Cloud-Infrastruktur .

Schemabild

Remote-Speicheroptionen

Sie können den Remote-Speicher mit der Option remote-storage mit dem Befehl setup CLI command konfigurieren. Die Option remote-storage verwendet die folgende Syntax:

--remote-storage-<parameter-name>="<parameter-value>"

Der parameter-name bezieht sich auf den Namen des spezifischen Remote-Speicherparameters. In der folgenden Tabelle sind die Parameter aufgeführt, die für die Konfiguration des Remote-Speichers verfügbar sind:

Befehlszeilenparameter
Parametername
Beschreibung
Standardwert
remote-storage-driver
Treiber
Adaptername
Mögliche Werte:
file: Deaktiviert den Remote-Speicher und verwendet das lokale Dateisystem
aws-s3: Verwenden Sie den Amazon Simple Storage Service (Amazon S3)
Keine
remote-storage-bucket
Bucket
Objektspeicherung oder Containername
Keine
remote-storage-prefix
prefix
Optionales Präfix (Speicherort innerhalb des Objektspeichers)
leer
remote-storage-region
region
Regionsname
Keine
remote-storage-key
Zugriffsschlüssel
Optionaler Zugriffsschlüssel
leer
remote-storage-secret
geheimer Schlüssel
Optionaler geheimer Schlüssel
leer

Speicheradapter

Der standardmäßige Speicherort befindet sich im lokalen Dateisystem. Mit einem Speicheradapter können Sie eine Verbindung zu einem Speicherdienst herstellen und Ihre Dateien an einer beliebigen Stelle speichern. Commerce unterstützt die Konfiguration der folgenden Speicherdienste:

Remote-Speicher aktivieren

Sie können den Remote-Speicher während einer Adobe Commerce-Installation installieren oder einer bestehenden Commerce-Instanz Remote-Speicher hinzufügen. In den folgenden Beispielen werden die einzelnen Methoden anhand eines Satzes von remote-storage Parametern mit Commerce setup-CLI-Befehlen veranschaulicht. Minimal müssen Sie den Speicher driver, bucket und region bereitstellen.

  • Beispiel: Installieren von Commerce mit Remote-Speicher

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Beispiel: Remote-Speicher auf vorhandenem Commerce aktivieren

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Informationen zu Adobe Commerce in der Cloud-Infrastruktur finden Sie unter Konfigurieren des Remote-Speichers für Commerce in der Cloud-Infrastruktur.

Einschränkungen

Es ist nicht möglich, sowohl Remote-Speicher als auch Datenbankspeicher gleichzeitig zu aktivieren. Deaktivieren Sie den Datenbankspeicher, wenn Sie Remote-Speicher verwenden.

bin/magento config:set system/media_storage_configuration/media_database 0

Die Aktivierung des Remote-Speichers kann sich auf Ihr bestehendes Entwicklungs-Erlebnis auswirken. Beispielsweise funktionieren bestimmte PHP-Dateifunktionen möglicherweise nicht erwartungsgemäß. Die Verwendung von Commerce Framework für Dateivorgänge muss erzwungen werden.

Die Liste der verbotenen nativen PHP-Funktionen ist im magento-coding-standard repository verfügbar.

Migrieren von Inhalten

Nachdem Sie den Remote-Speicher für einen bestimmten Adapter aktiviert haben, können Sie mithilfe der CLI vorhandene media-Dateien in den Remote-Speicher migrieren.

./magento2ce/bin/magento remote-storage:sync
INFO
Der Synchronisierungsbefehl migriert nur Dateien im Ordner pub/media, nicht jedoch die Import-/Exportdateien im Verzeichnis var. __ Siehe Geplanter Import/Export im Commerce 2.4-Benutzerhandbuch.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c