We use Composer to manage Magento Commerce Cloud dependencies and upgrades and provide context about the included packages, what the packages do, and how they fit together. We highly recommend experience with Composer.
Composer manages required libraries and dependencies for your project and installs them in the
For Magento Commerce Cloud, we use the
composer.lock files, located in the project root directory, to manage the modules list, packages, dependencies, and so on for determining upgrades, patches, hotfixes, and more.
Magento extension and module developers use the
composer.json file to manage product installations and upgrades. See Install, manage, and upgrade extensions.
composer.lock file stores a set of exact version dependencies that satisfy all of the version constraints of every requirement for every package in the dependency tree of the project.
||Updates to the latest versions of the dependencies. You must update every time you edit dependencies in the
The workflow is as follows:
- Make a change to
composer.json. For example, edit this file when installing an extension or module.
composer.lockto or update it in your Cloud Git repository.
- Push the changes to the Cloud environment, which causes Cloud to build and deploy the environment.
During the build phase, the Cloud environment runs
composer install on a fresh clone of your Git branch to retrieve the latest dependencies.
magento/magento-cloud-metapackage should be the only package in the
require section of your
composer.json. This is a metapackage and does not contain any code.
The metapackage depends on the appropriate versions of
magento/product-enterprise-edition. At any given version, this package requires the same version of
magento/product-enterprise-edition. Therefore, to use Magento Commerce version 2.1.4, for example,
composer.json must specify a requirement for
magento/magento-cloud-metapackage version 2.1.4.
This package depends on a floating version of
magento/magento-cloud-configuration (abbreviated MCC). It depends on the major and minor version of MCC that correspond to the specified Magento Commerce version, and floats on the patch version so that compatible updates to this packages can be automatically pulled by running
This package contains the following scripts and
magento commands that automatically perform building and deployment of the codebase on the cloud environment:
magento/magento-cloud-configuration also contains patch files that are specific to Cloud.
There is a many-to-one relationship between the MCC version and Magento versions.
For Magento Commerce, versions are specified as
MCC versions are specified as:
<100 + x>.<y>.*. For example, Magento Commerce 2.1.4 is associated with MCC 101.4.0. Subsequently, a new version of MCC could be released that corresponds to the same Magento Commerce version, and it would be 101.4.1.
We release updated MCC code to add a new patch or to improve the build and deploy hooks.
To check for patches, you can check the
This metapackage requires Magento application components, including modules, frameworks, themes, and so on.
ece-tools package is compatible with Magento version 2.1.4 and later to provide a rich set of features you can use to manage your Magento Commerce Cloud project. It contains scripts and Magento Commerce Cloud commands designed to help manage your code and automatically build and deploy your Cloud projects.
Base packages and file marshalling
Magento contains two base packages,
magento/magento2-ee-base. These packages contain interstitial files that cannot be classified as extensions, themes, frameworks, or language packages; for example, sample server configuration files, PHP
entry points, and so on.
These files are location-dependent, and cannot reside in the
vendor directory. They are distributed as part of the base packages, and they rely on hooks located in the
magento/magento-composer-installer package, which marshals them to the appropriate locations.
One way in which Magento Commerce deploys differently than other Magento installations is that it does not marshal base packages on the Cloud environment. This could change in a future Cloud release, but for now, on the Cloud environment specifically, the marshalling functionality of
magento/magento-composer-installer is disabled.
Therefore, when upgrading to a new Cloud version or adding, removing, or changing any packages that rely on file marshalling, you must:
The new version of the base packages are marshalled out into the Cloud project root directory, which means files are added, removed, and changed.
File marshalling works on your local system but not on the Cloud server.
- Add and commit these updated files to your Cloud Git repository.
- Push the changes to your Cloud integration environment.
For more information, see:
- Upgrade and test Magento Commerce for upgrading to a new version of Magento
- Patch and test Magento Commerce for applying patches
This makes sure that base files are placed in the correct location and are under source control. If you notice any problems after deploying an updated version of Magento, one of the first things to check should be whether all of the base package files were added to source control.