Dokumentation Commerce Handbuch zu Commerce mit Cloud Infrastructure

Upgrade des Projekts zur Verwendung des ECE-Tools-Pakets

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Cloud

Erstellt für:

Admin
Entwickler

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

WARNING

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

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

TIP

Bevor Sie mit einem Upgrade- oder Patchprozess beginnen, erstellen Sie einen aktiven Zweig aus der Integrationsumgebung und checken Sie die neue Verzweigung auf Ihrer lokalen Workstation aus. Wenn Sie eine Verzweigung dem Upgrade- oder Patch-Prozess zuweisen, können Sie Störungen Ihrer laufenden Arbeit vermeiden.

Entfernen veralteter Pakete

Überprüfen Sie vor dem Ausführen eines Upgrades zur Verwendung des ece-tools-Pakets die Datei composer.lock auf die folgenden veralteten Pakete:

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

Metapaket aktualisieren

Für jede Adobe Commerce-Version sind unterschiedliche Einschränkungen erforderlich, die auf Folgendes basieren:

>=current_version <next_version

Geben Sie für "current_version"die zu installierende Adobe Commerce-Version an.
Geben Sie für 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. Durch die Beschränkung ">=2.3.5 <2.3.6" wird das neueste verfügbare Paket für 2.3.5 installiert.

Sie können die neueste Metapaket-Einschränkung immer in der magento-cloud Vorlage finden.

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

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

Projekt aktualisieren

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.

Aktualisieren des Projekts für die Verwendung von ece-tools:

Aktualisieren Sie die magento/magento-cloud-metapackage-Versionsbegrenzung in der Datei composer.json .

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

Aktualisieren Sie das Metapaket.

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

Ändern Sie die Hook-Befehle in der Datei "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 und entfernen Sie die veralteten Pakete. Die veralteten Pakete können eine erfolgreiche Aktualisierung verhindern.

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

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

Es kann erforderlich sein, das ece-tools -Paket zu aktualisieren.

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 Verzweigung integration zusammen.

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

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26