Update ece-tools version

When you update ece-tools, you also update the other Cloud Suite for Commerce packages, which are dependencies for ece-tools.


  • Before you update ece-tools, review the Cloud Suite for Commerce release notes.
  • If you are updating from ece-tools 2002.0.22 or earlier to 2002.1.0, review backward incompatible changes and make any required changes to your Cloud for Adobe Commerce project.
  • Review Upgrades and Patches to determine the ece-tools versions compatible with your Cloud for Adobe Commerce project.
  • You must use a version of Cloud for Adobe Commerce that supports the ece-tools package. The composer.json includes a dependency for the magento-cloud/metapackage and the hooks in the .magento.app.yaml file use ece-toolscommands to build, deploy, and run post-deploy hooks. If your project does not support ece-tools, you must upgrade your project.

Before beginning an upgrade or a patching process, create an active branch from the Integration environment and checkout the new branch to your local workstation. Dedicating a branch to the upgrade or the patch process helps to avoid interference with your work in progress.

To update the ece-tools package:

  1. On your local workstation, perform an update using Composer.

    composer update magento/ece-tools --with-dependencies

    If you cannot update beyond ece-tools version 2002.0.8, follow the upgrade steps.

  2. Add, commit, and push code changes.

    git add -A
    git commit -m "Update magento/ece-tools"
    git push origin <branch-name>
  3. After test validation, merge this branch to the Integration branch.