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
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.
- Before you update
ece-tools, review the Cloud Suite for Commerce release notes.
- If you are updating from
ece-tools2002.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
On your local workstation, perform an update using Composer.
composer update magento/ece-tools --with-dependencies
If you cannot update beyond
ece-toolsversion 2002.0.8, see Upgrade project.
Add, commit, and push code changes.
git add -A
git commit -m "Update magento/ece-tools"
git push origin <branch-name>
After test validation, merge this branch to the Integration branch.