This topic discusses how to update extensions you previously installed from Magento Marketplace or from another source.
Before you continue, you must:
- Know the extension’s Composer name and version
- Know the extension is compatible with your project (in particular, check the required PHP version)
You must check in
composer.lock to your environment; otherwise, the extension won't load in Magento Enterprise Cloud Edition. That's because we run
composer install (which uses
composer.lock) and not
composer update when we build and deploy the environment.
Find a extension’s Composer name
This section discusses how to get a extension’s Composer name and its version from Magento Marketplace. Alternatively, you can find the name and version of any extension (whether or not you purchased it on Marketplace) in the extension’s
composer.json file. Open
composer.json in a text editor and write down the values of
To get the extension’s Composer name from Magento Marketplace:
- Log in to Magento Marketplace with the user name and password you used to purchase the component.
In the upper right corner, click <your user name> > My Account as the following figure shows.
On the My Account page, click My Purchases as the following figure shows.
On the My Purchases page, click Technical Details for the extension you purchased as the following figure shows.
- Click Copy to copy the component name to the clipboard.
- Open a text editor.
- Paste the extension name in the text editor.
- Append a colon character (
:) to the component name.
- In Technical Details on the My Purchases page, click Copy to copy the version to the clipboard.
Append the version number to the component name after the colon.
A sample follows:
- Log in to your local development machine, or switch to, the Magento file system owner.
- Change to a directory to which the Magento file system owner has write access, such as the web server docroot.
Log in to your project:
List your projects:
If necessary, clone a project.
magento-cloud project:get <project ID>
Typically, you should clone the project in the web server’s docroot or a Virtual Host docroot.
Change to a project directory.
List environments in the project:
magento-cloud environment:listdisplays environment hierarchies whereas
git branchdisplays does not. If you have any nested environments, use
Fetch origin branches:
git fetch origin
Check out an environment:
magento-cloud environment:checkout <environment ID>
To create a new environment, use
magento-cloud environment:branch <environment name> <parent environment ID>
Pull updated code:
git pull origin <environment ID>
Create a snapshot of the environment.
magento-cloud snapshot:create -e <environment ID>
- If you haven’t done so already, change to your environment root directory.
composer.jsonin a text editor.
- Locate your extension.
- Update its version.
- Save your changes to
composer.jsonand exit the text editor.
Update project dependencies:
Enter the following commands in the order shown to commit the changes and deploy the project, including
git add -A git commit -m "<message>" git push origin <environment ID>
Wait for the project to deploy.
If there are errors, see Component deployment failure.