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][upgrade-project] to your cloud project to remove deprecated packages. To verify the ece-tools package is installed, retrieve the Commerce version using the php vendor/bin/ece-tools -V command at your local project root directory.

Prerequisites:

• 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 Adobe Commerce on cloud infrastructure project.
• Review Upgrades and Patches to determine the ece-tools versions compatible with your Adobe Commerce on cloud infrastructure 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.

   1
   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.

   1
   git add -A
   

   1
   git commit -m "Update magento/ece-tools"
   

   1
   git push origin <branch-name>
   

3. After test validation, merge this branch to the Integration branch.