Upgrade

We recommend that you use the latest version of Cloud Docker for Commerce. The version requirement is specified in the composer.json file for your project. Use the following instructions for the upgrade process.

Cloud Docker for Commerce releases sometimes introduce changes to the format and options in the docker-compose.yml file. We recommend creating a back up of your existing docker-compose.yml file before upgrading so you can review the changes. If you have custom configurations that you want to preserve across builds, move them to the docker-compose.override.yml file before you rebuild or upgrade the Docker environment.

To update the Cloud Docker for Commerce package for On-premises projects:

  1. On your local workstation, update the Cloud Docker for Commerce package using Composer.

    1
    
     composer update magento/magento-cloud-docker --with-dependencies
    
  2. Add, commit, and push code changes.

    1
    
    git add -A
    
    1
    
    git commit -m "Update magento/magento-cloud-docker"
    
    1
    
    git push origin <branch-name>
    
  3. Preserve custom configuration.

After you upgrade to the latest version of Cloud Docker for Commerce, stop and restart the Docker environment.