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