Dokumentation Commerce Handbuch zu Commerce für Cloud

Upgrade des Projekts auf das ECE-Tools-Paket

Last update: Wed Apr 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Cloud

Erstellt für:

Admin
Entwickler

Adobe hat die magento/magento-cloud-configuration- und magento/ece-patches-Pakete zugunsten des ece-tools-Pakets verworfen, was viele Cloud-Prozesse vereinfacht. Wenn Sie ein älteres Adobe Commerce in einem Cloud-Infrastrukturprojekt verwenden, das nicht das ece-tools enthält, müssen Sie für Ihr Projekt einen einmaligen manuellen Prozess Upgrade durchführen.

WARNING

Wenn Ihr Projekt das ece-tools enthält, können Sie das folgende Upgrade überspringen. Rufen Sie zur Überprüfung die Commerce Version mit dem Befehl php vendor/bin/ece-tools -V im lokalen Projektstammverzeichnis ab.

Für diesen Projekt-Upgrade-Prozess müssen Sie die magento/magento-cloud-metapackage Versionsbeschränkung in der composer.json-Datei im Stammverzeichnis aktualisieren. Diese Einschränkung ermöglicht Aktualisierungen für Adobe Commerce in Cloud-Infrastruktur-Metapaketen, einschließlich der Entfernung veralteter Pakete, ohne die aktuelle Adobe Commerce-Version zu aktualisieren.

TIP

Bevor Sie mit einem Upgrade oder einem Patch-Vorgang beginnen, erstellen Sie eine aktive Verzweigung aus der Integrationsumgebung und checken Sie die neue Verzweigung auf Ihrer lokalen Workstation aus. Wenn Sie dem Upgrade- oder Patch-Prozess eine Verzweigung zuweisen, vermeiden Sie Konflikte mit laufenden Arbeiten.

Veraltete Pakete entfernen

Bevor Sie ein Upgrade für die Verwendung des ece-tools durchführen, überprüfen Sie die composer.lock-Datei auf die folgenden veralteten Pakete:

magento/magento-cloud-configuration
magento/ece-patches

Metapaket aktualisieren

Jede Adobe Commerce-Version erfordert eine andere Einschränkung, die auf den folgenden Elementen basiert:

>=current_version <next_version

Geben Sie current_version die zu installierende Adobe Commerce-Version an.
Geben Sie next_version die nächste Patch-Version nach dem in current_version angegebenen Wert an.

Wenn Sie Adobe Commerce 2.3.5-p2 installieren möchten, setzen Sie current_version auf 2.3.5 und die next_version auf 2.3.6. Mit der ">=2.3.5 <2.3.6" wird das neueste verfügbare Paket für 2.3.5 installiert.

Die neueste Metapaket-Einschränkung finden Sie immer in der magento-cloud Vorlage.

Im folgenden Beispiel wird eine Einschränkung für das Metapaket für die Adobe Commerce-Cloud-Infrastruktur auf eine Version festgelegt, die größer oder gleich der aktuellen Version 2.4.8 und kleiner als die nächste Version 2.4.9 ist:

"require": {
    "magento/magento-cloud-metapackage": ">=2.4.8 <2.4.9"
},

Aktualisieren des Projekts

Um Ihr Projekt für die Verwendung des ece-tools-Pakets zu aktualisieren, müssen Sie das Metapaket und die .magento.app.yaml Hooks-Eigenschaften aktualisieren und eine Composer-Aktualisierung durchführen.

So aktualisieren Sie das Projekt auf ECE-Tools:

Aktualisieren Sie die magento/magento-cloud-metapackage Versionsbeschränkung in der composer.json.

code language-bash
`composer require "magento/magento-cloud-metapackage":">=2.4.8 <2.4.9" --no-update`

Aktualisieren Sie das Metapaket.

code language-bash
`composer update magento/magento-cloud-metapackage`

Ändern Sie die Hook-Befehle in der magento.app.yaml.

code language-yaml

code language-yaml
hooks: # We run build hooks before your application has been packaged. build: \| set -e php ./vendor/bin/ece-tools run scenario/build/generate.xml php ./vendor/bin/ece-tools run scenario/build/transfer.xml # We run deploy hook after your application has been deployed and started. deploy: \| php ./vendor/bin/ece-tools run scenario/deploy.xml # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10. post_deploy: \| php ./vendor/bin/ece-tools run scenario/post-deploy.xml

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        php ./vendor/bin/ece-tools run scenario/build/generate.xml
        php ./vendor/bin/ece-tools run scenario/build/transfer.xml
    # We run deploy hook after your application has been deployed and started.
    deploy: |
        php ./vendor/bin/ece-tools run scenario/deploy.xml
    # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10.
    post_deploy: |
        php ./vendor/bin/ece-tools run scenario/post-deploy.xml

Suchen Sie nach den veralteten Paketen und entfernen Sie diese. Die veralteten Pakete können ein erfolgreiches Upgrade verhindern.

code language-bash
`composer remove magento/magento-cloud-configuration`

code language-bash
`composer remove magento/ece-patches`

Möglicherweise muss das ece-tools aktualisiert werden.

code language-bash
`composer update magento/ece-tools`

Fügen Sie die Code-Änderungen hinzu und übertragen Sie sie. In diesem Beispiel wurden die folgenden Dateien aktualisiert:

code language-none
`.magento.app.yaml composer.json composer.lock`

Übertragen Sie Ihre Code-Änderungen auf den Remote-Server und führen Sie diese Verzweigung mit der integration Verzweigung zusammen.

code language-bash
`git push origin <branch-name>`

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938