Update ece-tools version

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


  • Before you update ece-tools, review the Magento Commerce Cloud Suite 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 Magento Commerce Cloud project.
  • Review Upgrades and Patches to determine the ece-tools versions compatible with your Magento Commerce Cloud project.
  • You must use a version of Magento Commerce Cloud 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

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

  2. Add, commit, and push your 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.