Remote-Speicher für Commerce in Cloud-Infrastruktur konfigurieren

Ab dem ece-tools -Paket 2002.1.5 können Sie eine Umgebungsvariable verwenden, um das Remote-Speichermodul zu aktivieren. Das Remote-Speichermodul unterstützt jedoch in Adobe Commerce in der Cloud-Infrastruktur eingeschränkte Unterstützung. Adobe kann keine vollständige Fehlerbehebung für den Speicheradapterdienst von Drittanbietern durchführen.

Umgebungsvariable

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

REMOTE_STORAGE

  • StandardNicht festgelegt
  • Version—Commerce 2.4.2 und höher

Konfigurieren Sie einen Speicheradapter, um Mediendateien mithilfe eines Speicherdienstes wie AWS S3 in einem beständigen Remote-Speicherbehälter zu speichern. Aktivieren Sie das Remote-Speichermodul, um die Leistung bei Cloud-Projekten mit komplexen Multi-Server-Konfigurationen zu verbessern, die Ressourcen gemeinsam nutzen müssen. Im Folgenden finden Sie ein Beispiel für die Konfiguration des Remote-Speichers mit der Datei .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

Variable mit Cloud CLI festlegen

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

Hinzufügen der Remote-Speichervariablen mithilfe der 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 Variable "REMOTE_STORAGE" benötigt eine JSON-Zeichenfolge, um den Remote-Speicher zu konfigurieren. Im Folgenden finden Sie ein Beispiel für eine JSON-Konfiguration:

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

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

Variable mit Projekt-Web-Schnittstelle festlegen

Alternativ können Sie die Variable über die Projekt-Webschnittstelle zur entsprechenden Umgebung hinzufügen.

Hinzufügen der Remote-Speichervariablen mithilfe der Projekt-Webschnittstelle:

  1. Wählen Sie auf der Projekt-Webschnittstelle die Umgebung links aus.

  2. Klicken Sie auf das Symbol Umgebung konfigurieren .

  3. Klicken Sie in der Ansicht Umgebung konfigurieren auf die Registerkarte Variablen .

  4. Klicken Sie auf Variable hinzufügen.

  5. Geben Sie im Feld Name den Wert REMOTE_STORAGE ein.

  6. Fügen Sie im Feld Wert die JSON-Konfiguration hinzu.

  7. Wählen Sie JSON-Wert und Sensitiv aus; heben Sie die Auswahl von Vererbbar durch untergeordnete Umgebungen auf.

  8. Klicken Sie auf Variable hinzufügen.

Optionale Authentifizierung verwenden

Die key und secret sind optional. Wenn Sie die Variable erstellen, können Sie die key und die secret ausblenden, indem Sie die Option sensitive auswählen. Mit dieser Einstellung sind die Werte nicht in der Web-Oberfläche sichtbar. Siehe Variablenanzeige im Leitfaden Commerce on Cloud Infrastructure.

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 stellen Sie sicher, dass der Server für den S3-Bucket autorisiert ist.

Remote-Speicher synchronisieren

Nachdem Sie das Remote Storage-Modul aktiviert haben, synchronisieren Sie die aktuellen Mediendateien mit dem Remote Store-Speicherort.

Starten der Synchronisierung:

  1. Verwenden Sie SSH, um sich bei der Remote-Umgebung mit konfiguriertem Remote-Speicher anzumelden.

  2. Starten Sie die Synchronisierung.

bin/magento remote-storage:sync

Schnelle Konfiguration

Wenn Sie die Remote-Speicherlösung mit einem Adobe Commerce-Projekt für die Cloud-Infrastruktur verwenden möchten, verwenden Sie die Anleitung Amazon S3 in der Dokumentation Fastly , um sicherzustellen, dass die Fastly-Bildoptimierung mit AWS S3 funktioniert.

Bereiten Sie sich mit Ihren Fastly-Anmeldedaten vor. Verwenden Sie in Pro-Projekten SSH, um eine Verbindung zu Ihrem Server herzustellen und die Fastly-Anmeldeinformationen aus der Datei /mnt/shared/fastly_tokens.txt zu erhalten. 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 der Einrichtung des Remote-Speichers für Cloud-Projekte fort:

  1. Konfigurieren Sie eine schnelle Backend-Integration.

  2. Erstellen Sie eine VCL-Logik für die AWS S3-Authentifizierung.

  3. Erstellen Sie eine VCL-Logik für Backend-Anforderungen an den AWS S3-Behälter.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c