ECE-Tools パッケージを使用するようにプロジェクトをアップグレード

最終更新日： 2025年10月14日

トピック：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

作成対象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Adobeでは、magento/magento-cloud-configurationおよびmagento/ece-patches パッケージが非推奨となり、多くのクラウドプロセスを簡素化するece-tools パッケージが優先されました。 notにece-tools パッケージが含まれている古いAdobe Commerce on cloud infrastructure プロジェクトを使用する場合は、プロジェクトに対して1回限りの手動 アップグレード 処理を実行する必要があります。

WARNING

プロジェクトにece-tools パッケージが含まれている場合は、次のアップグレードをスキップできます。確認するには、ローカルプロジェクトのルートディレクトリでphp vendor/bin/ece-tools -V コマンドを使用してCommerce バージョンを取得します。

このプロジェクトのアップグレードプロセスでは、ルートディレクトリのcomposer.json ファイルのmagento/magento-cloud-metapackage バージョン制約を更新する必要があります。この制約により、現在のAdobe Commerce バージョンをアップグレードすることなく、非推奨のパッケージの削除など、Adobe Commerce on cloud infrastructure メタパッケージのアップデートが可能になります。

TIP

アップグレードまたはパッチ適用プロセスを開始する前に、統合環境からアクティブなブランチを作成し、新しいブランチをローカルワークステーションにチェックアウトします。アップグレードまたはパッチプロセスにブランチを割り当てることで、進行中の作業への干渉を回避できます。

非推奨パッケージの削除

ece-tools パッケージを使用するようにアップグレードを実行する前に、次の非推奨パッケージについてcomposer.lock ファイルを確認してください。

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

メタパッケージの更新

Adobe Commerceの各バージョンには、次の要素に基づいて異なる制約が必要です。

>=current_version <next_version

current_versionに、インストールするAdobe Commerce バージョンを指定します。
next_versionの場合、current_versionで指定した値の後に次のパッチバージョンを指定します。

Adobe Commerce 2.3.5-p2をインストールする場合は、current_versionを2.3.5に、next_versionを2.3.6に設定します。制約">=2.3.5 <2.3.6"は、2.3.5の利用可能な最新のパッケージをインストールします。

最新のメタパッケージ制約は、magento-cloud テンプレートにいつでも見つけることができます。

次の例では、Adobe Commerce on cloud infrastructure メタパッケージの制約を、現在のバージョン 2.4.8以上のバージョンと次のバージョン 2.4.9未満のバージョンに設定します。

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

プロジェクトのアップグレード

プロジェクトをアップグレードしてece-tools パッケージを使用するには、メタパッケージと.magento.app.yaml フックのプロパティを更新し、Composerの更新を実行する必要があります。

ece-toolsを使用するようにプロジェクトをアップグレードするには：

composer.json ファイルのmagento/magento-cloud-metapackage バージョン制約を更新します。

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

メタパッケージを更新します。

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

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

非推奨パッケージを確認して削除します。非推奨パッケージは、アップグレードの成功を妨げる可能性があります。

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

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

ece-tools パッケージを更新する必要がある場合があります。

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

コードの変更を追加してコミットします。この例では、次のファイルが更新されました。

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

コードの変更をリモートサーバーにプッシュし、このブランチをintegration ブランチと結合します。

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

recommendation-more-help

commerce-on-cloud-help-cloud-guide