Dokumentation Commerce Handbuch zu Commerce für Cloud

Abwärtsinkompatible Änderungen

Letzte Aktualisierung: 31. Januar 2025

Themen:
Cloud

Erstellt für:

Admin
Entwickler

Abwärtsinkompatible Änderungen erfordern möglicherweise, dass Sie die Cloud-Konfiguration und Prozesse für bestehende Cloud-Projekte anpassen, wenn Sie auf die neueste Version des ece-tools-Pakets oder andere Cloud-Tools-Pakete für Commerce aktualisieren.

Änderungen an `ece-tools` Paket

Einige Funktionen, die zuvor im ece-tools enthalten waren, werden jetzt in separaten Paketen bereitgestellt. Diese Pakete sind Composer-Abhängigkeiten für ece-tools, die automatisch installiert und aktualisiert werden, wenn Sie ece-tools installieren oder aktualisieren.

Die neue Architektur sollte keine Auswirkungen auf Ihre Installations- oder Aktualisierungsprozesse haben. Möglicherweise müssen Sie jedoch bei der Arbeit mit Ihrem Adobe Commerce in einem Cloud-Infrastrukturprojekt einige Befehlssyntax und Prozesse ändern. Weitere Informationen finden Sie in den folgenden abwärtsinkompatiblen Änderungen und in den Versionshinweisen zur Cloud-Tools-Suite.

Änderungen der Dienstversionsanforderungen

Wir haben die Mindestanforderung für die PHP-Version von 7.0.x auf 7.1.x für Cloud-Projekte geändert, die ece-tools v2002.1.0 und höher verwenden. Wenn Ihre Umgebungskonfiguration PHP 7.0 angibt, aktualisieren Sie die php-Konfiguration in der .magento.app.yaml.

WARNING

Aufgrund der Änderung der PHP-Versionsanforderung unterstützt ece-tools 2002.1.0 nur Adobe Commerce in Cloud-Infrastrukturprojekten, die Adobe Commerce 2.1.15 oder höher ausführen. Wenn Ihr Projekt eine frühere Version verwendet, müssen Sie aktualisieren bevor Sie auf ece-tools 2002.1.0 aktualisieren.

Änderungen an der Umgebungskonfiguration

Die folgende Tabelle enthält Informationen zu Umgebungsvariablen und anderen Umgebungskonfigurationsdateien, die in ece-tools v2002.1.0 entfernt wurden oder veraltet sind.

Element	Ersatz
`SCD_EXCLUDE_THEMES`	`SCD_MATRIX`
`STATIC_CONTENT_THREADS`	`SCD_THREADS`
`DO_DEPLOY_STATIC_CONTENT`	`SKIP_SCD`
`STATIC_CONTENT_SYMLINK`	Keine. Jetzt erstellt der Build immer einen Symlink zum statischen Inhaltsverzeichnis `pub/static`.
`build_options.ini`	Verwenden Sie die `.magento.env.yaml`-Datei, um Umgebungsvariablen zu konfigurieren, um Aktionen zum Erstellen und Bereitstellen in allen Ihren Umgebungen zu verwalten. Wenn Sie eine Cloud-Umgebung erstellen, die die `build_options.ini` enthält, schlägt der Build fehl.

CLI-Befehlsänderungen

Die folgende Tabelle fasst die CLI-Befehlsänderungen in ECE-Tools v2002.1.0 zusammen, die möglicherweise eine Aktualisierung von Befehlen oder Skripten erfordern.

Befehl	Ersatz
`m2-ece-build`	`vendor/bin/ece-tools build`
`m2-ece-deploy`	`vendor/bin/ece-tools deploy`
`m2-ece-scd-dump`	`vendor/bin/ece-tools config:dump`
`vendor/bin/ece-tools patch`	`vendor/bin/ece-patches apply`
`vendor/bin/ece-tools docker:build`	`vendor/bin/ece-docker build:compose`
`vendor/bin/ece-tools docker:config:convert`	`vendor/bin/ece-docker image:generate:php`

In früheren ECE-Tools-Versionen konnten Sie die m2-ece-build und m2-ece-deploy-Befehle verwenden, um Bereitstellungs-Hooks in der .magento.app.yaml-Datei zu konfigurieren. Überprüfen Sie beim Aktualisieren auf Version 2002.1.0 die hooks in der .magento.app.yaml auf veraltete Befehle, und ersetzen Sie sie bei Bedarf.

Änderungen an Cloud-Patches

Heruntergeladene Patches entfernen-Das magento/magento-cloud-patches Paket bündelt alle auf der Seite „SoftwareDownloads“ verfügbaren Patchesund wendet sie automatisch bei der Bereitstellung in der Cloud an. Um Patchkonflikte nach einem Upgrade auf ECE-Tools 2002.1.0 oder höher zu vermeiden, entfernen Sie alle von Adobe bereitgestellten Patches, die Sie manuell heruntergeladen und zu Ihrem Projekt hinzugefügt haben.
Befehl zum Anwenden von Patches wurde aktualisiert-Der Befehl zum Anwenden von Patches wurde aus dem vendor/bin/ece-tools in das vendor/bin/ece-patches-Verzeichnis verschoben. Wenn Sie diesen Befehl verwenden, um Patches manuell anzuwenden, verwenden Sie den neuen Pfad.

Patches manuell anwenden
php ./vendor/bin/ece-patches apply

Cloud Docker-Änderungen

Die Mindestanforderung für die PHP-Version lautet jetzt PHP 7.1-Wenn Ihr Cloud Docker für Commerce-Host eine frühere Version ausführt, führen Sie ein Upgrade auf PHP v7.1 oder höher durch.
Befehlsänderungen von Cloud Docker für Commerce-
- Aktualisieren von Cloud Docker für Commerce-Befehle für Docker-Build-Vorgänge-Wir haben die Cloud Docker für Commerce-Befehle aus dem vendor/bin/ece-tools in das vendor/bin/ece-docker-Verzeichnis verschoben. Aktualisieren Sie Ihre Skripte und Befehle, um den neuen Pfad zu verwenden.
  
  Nach dem Upgrade auf ece-tools 2002.1.0 verwenden Sie den folgenden Befehl, um verfügbare ece-docker anzuzeigen.
  php ./vendor/bin/ece-docker list
- Aktualisieren der Cloud-Docker--Wir haben den Pfad zur Befehlsdatei von ./bin/docker in ./bin/magento-docker umbenannt. Aktualisieren Sie Ihre Skripte und Befehle, um den neuen Pfad zu verwenden.
- Cron-Container ist nicht mehr in der standardmäßigen Docker-Konfiguration enthalten-Jetzt müssen Sie die --with-cron-Option zum ece-docker build:compose-Befehl hinzufügen, um den Cron-Container in die Docker-Umgebungskonfiguration aufzunehmen. Siehe Verwalten von Cron-Aufträgen im Handbuch Cloud Docker for Commerce.
  
  Skripte, die zuvor Container mit Cron-Aufträgen generiert haben, sind jetzt ohne den Cron-Container.
- Verwenden temporärer Container-In früheren Versionen wurden die von bin/magento-docker Befehlsvorgängen erstellten Container nicht entfernt, sodass Sie sie für andere Vorgänge verwenden konnten. Jetzt entfernen die magento-docker-Befehle alle Container, die sie nach Abschluss des Befehls erstellen.
  
  Wenn Sie einen durch einen Docker-Compose-Vorgang erstellten Container beibehalten möchten, verwenden Sie den docker-compose run-Befehl anstelle des bin/magento-docker-Befehls.
- Ausführen von Hooks nach der Bereitstellung-Der cloud-deploy Befehl führt keine Hooks nach der Bereitstellung mehr aus. Verwenden Sie den neuen cloud-post-deploy-Befehl, um nach der Bereitstellung Hooks auszuführen. Aktualisieren Sie Ihre Skripte, um den Befehl zum Ausführen von Hooks nach der Bereitstellung hinzuzufügen.
  bin/magento-docker ece-deploy bin/magento-docker ece-post-deploy
  Wenn Sie docker-compose-Befehle direkt verwenden, führen Sie alternativ den docker-compose run deploy cloud-post-deploy-Befehl nach dem Bereitstellungsbefehl aus.
Datenbank aktualisieren-Der Datenbank-Container ist jetzt im magento-db persistenten Docker-Volume gespeichert. Wenn Sie die Docker-Umgebung aktualisieren, wird die Datenbank nicht mehr automatisch gelöscht. Verwenden Sie bei Bedarf einen der folgenden Befehle, um ihn manuell zu entfernen.
- Entfernen Sie den magento-db:
  docker volume rm magento-db
- Entfernen Sie alle zugehörigen Volumes, wenn Sie die Docker-Container herunterfahren:
  docker-compose down -v
Dateisynchronisierungseinstellungen für Archiv- und Sicherungsdateien überschreiben-Archiv- und Sicherungsdateien mit den folgenden Erweiterungen werden bei Verwendung von docker-sync oder mutagen nicht mehr synchronisiert: SQL, GZ, ZIP und BZ2. Sie können die standardmäßige Dateisynchronisierung für diese Dateitypen überschreiben, indem Sie die Datei so umbenennen, dass sie mit einer anderen Erweiterung endet. Beispiel: synchronize-me.zip-backup

recommendation-more-help