[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Konfigurieren des Remote-Speichers für Commerce in der Cloud-Infrastruktur

Ab dem ece-tools-Paket 2002.1.5 können Sie eine Umgebungsvariable verwenden, um das Remote-Speichermodul zu aktivieren. Das Remote-Speichermodul bietet jedoch begrenzte Unterstützung für Adobe Commerce in der Cloud-Infrastruktur. Adobe kann den Speicheradapterdienst eines Drittanbieters nicht vollständig beheben.

Umgebungsvariable

Die Variable REMOTE_STORAGE wird während der Bereitstellungsphase eines Cloud-Infrastrukturprojekts verwendet.

REMOTE_STORAGE

Konfigurieren Sie einen Speicheradapter, um Mediendateien mithilfe eines Speicherdienstes wie AWS S3 in einem persistenten Remote-Speicher-Container zu speichern. Aktivieren Sie das Remote-Speichermodul, um die Leistung in Cloud-Projekten mit komplexen Multi-Server-Konfigurationen zu verbessern, die Ressourcen gemeinsam nutzen müssen. Im Folgenden finden Sie ein Beispiel für die Remote-Speicherkonfiguration unter Verwendung der .magento.env.yaml:

stage:
  deploy:
    REMOTE_STORAGE:
      driver: aws-s3 # Required
      prefix: cloud # Optional
      config:
        bucket: my-bucket # Required
        region: my-region # Required
        key: my-key # Optional
        secret: my-secret-key # Optional

Festlegen einer Variablen mit Cloud CLI

Legen Sie die REMOTE_STORAGE-Variable als Variable auf Umgebungsebene) fest sodass Dateien nicht zwischen Produktions-, Staging- und Integrationsumgebungen freigegeben werden. Das Festlegen der Variablen auf Umgebungsebene bietet die Flexibilität, nur den Remote-Speicher in ausgewählten Umgebungen zu verwenden, z. B. die Verwendung des Remote-Speichers in der Integrationsumgebung auszuschließen.

So fügen Sie die Remote-Speichervariable über die Cloud-CLI:

magento-cloud variable:create --level environment --name REMOTE_STORAGE --json true --inheritable false --value '{"driver":"aws-s3","prefix":"uat","config":{"bucket":"aws-bucket-id","region":"eu-west-1","key":"optional-key","secret":"optional-secret"}}'

Dadurch wird eine REMOTE_STORAGE Variable mit der angegebenen JSON-Konfiguration erstellt. Die REMOTE_STORAGE-Variable benötigt eine JSON-Zeichenfolge, um den Remote-Speicher zu konfigurieren. Im Folgenden finden Sie eine JSON-Beispielkonfiguration:

{
  "driver": "aws-s3",
  "prefix": "uat",
  "config": {
    "bucket": "aws-bucket-id",
    "region": "aws-region-id",
    "key": "optional-key",
    "secret": "optional-secret"
  }
}

Nachdem Sie die Konfiguration erstellt und bereitgestellt haben, sollten die Bereitstellungsprotokolle Informationen zur Remote-Speicherkonfiguration enthalten, z. B. INFO: Remote storage driver set to: "aws-s3"

Festlegen einer Variablen mit Project Web Interface

Alternativ können Sie die Project-Web-Schnittstelle verwenden, um die Variable der entsprechenden Umgebung hinzuzufügen.

So fügen Sie die Remote-Speichervariable über die Project Web Interface- hinzu:

Optionale Authentifizierung verwenden

key und secret sind optional. Wenn Sie die Variable erstellen, können Sie die key und secret ausblenden, indem Sie die Option sensitive auswählen. Bei dieser Einstellung sind die Werte nicht in der Web-Oberfläche sichtbar. Siehe Sichtbarkeit von Variablen im Handbuch zu Commerce in Cloud-Infrastrukturen.

Wenn Sie eine andere Authentifizierungsmethode verwenden möchten, lassen Sie die key und secret aus der JSON-Konfiguration weg. Konfigurieren Sie die alternative Authentifizierungsmethode und überprüfen Sie, ob der Server für den S3-Bucket autorisiert ist.

Remote-Speicher synchronisieren

Synchronisieren Sie nach der Aktivierung des Remote-Speichermoduls die aktuellen Mediendateien mit dem Remote-Speicherort.

Starten der Synchronisierung:

bin/magento remote-storage:sync

Fastly-Konfiguration

Wenn Sie sich für die Verwendung der Remote-Speicherlösung mit einem Adobe Commerce in einem Cloud-Infrastrukturprojekt entscheiden, verwenden Sie die Amazon S3-Anleitung in der Fastly-Dokumentation, um sicherzustellen, dass Fastly Image Optimization mit AWS S3 funktioniert.

Seien Sie mit Ihren Fastly-Anmeldedaten vorbereitet. Bei Pro-Projekten stellen Sie mit SSH eine Verbindung zu Ihrem Server her und erhalten die Fastly-Anmeldedaten aus der /mnt/shared/fastly_tokens.txt. Staging- und Produktionsumgebungen verfügen über eindeutige Anmeldeinformationen. Sie müssen die Anmeldeinformationen für jede Umgebung abrufen.

Fahren Sie mit den folgenden Aufgaben mit dem Einrichten des Remote-Speichers für Cloud-Projekte fort: