This page has moved and will be redirected soon. See Migrated topics for the complete list.

Update ece-tools version

An update to the ece-tools package also updates the other Cloud Suite for Commerce packages, which are dependencies for ece-tools. Therefore, you must use a version of Adobe Commerce on cloud infrastructure that supports the ece-tools package.

If you use a version of Adobe Commerce on cloud infrastructure that does not contain the ece-tools package, then you must perform a one-time upgrade to your cloud project to remove deprecated packages. To verify the ece-tools package is installed, retrieve the Commerce template version using the php vendor/bin/ece-tools -V command at your local project root directory.


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, see Upgrade project.

  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.