Development overview
Adobe Commerce on cloud infrastructure remote environments are Read Only, including all Starter environments and all Pro integration, Staging, and Production environments. In a local development environment, you can write and test code before pushing it to an integration environment for further testing and deployment to Staging and Production.
Before preparing your local workspace, ensure that you have your credentials. Local development requires PHP and Composer installation unless you opt to use Cloud Docker for Commerce.
Required packages
Adobe Commerce on cloud infrastructure uses Composer to manage the dependencies and upgrades for projects. For local development, you must install the PHP and Composer versions that are compatible with your Cloud project. For example, if you are using the Commerce 2.4.6 cloud template, you can see that the .magento.app.yaml configuration file uses PHP 8.2 and Composer 2.2.21.
Composer installs the required libraries and dependencies for your project in the vendor directory. The following required Composer files are in the project root directory:
composer.json—Use thecomposer.jsonfile to manage product installations and upgrades.composer.lock—Thecomposer.lockfile stores a set of exact version dependencies that satisfy the version constraints of every requirement for every package in the dependency tree of the project.
Common commands:
composer updatecomposer.json file. This updates the composer.lock file.composer installcomposer.lock file to download dependencies. It is a best practice to keep an up-to-date copy of composer.lock in your project repository.Once you add, commit, and push the updated code, the deployment process automatically runs the composer install command during the build phase.
Cloud metapackage
Adobe Commerce on cloud infrastructure uses a metapackage that requires magento/product-enterprise-edition. To get the latest updates for latest version of Commerce, use the following constraint syntax:
>=current_version <next_version
For example, to use the latest Adobe Commerce version 2.4.5, set 2.4.5 as the “current” version and 2.4.6 as the “next” version in the composer.json file:
"magento/magento-cloud-metapackage": ">=2.4.5 <2.4.6"
The main packages of this metapackage are the following:
- vendor/magento/ece-tools—The
ece-toolspackage is compatible with Adobe Commerce version 2.1.4 and later to provide a rich set of features you can use to manage your Adobe Commerce on cloud infrastructure project. It contains scripts and Adobe Commerce on cloud infrastructure commands designed to help manage your code and automatically build and deploy your projects. See theece-toolspackage overview. - vendor/magento/product-enterprise-edition—This metapackage requires application components, including modules, frameworks, themes, and more.
- vendor/fastly2/magento2—This module manages the Fastly CDN and services for the Pro Staging and Production and Starter Production environments. See Fastly services.
- vendor/magento/module-paypal-on-boarding—This module provides PayPal payment gateway checkout by connecting to your PayPal merchant account. See PayPal On-Boarding tool.
Docker environment
You can use the Cloud Docker for Commerce tool to emulate the Adobe Commerce on cloud infrastructure production and development environments for local development. Cloud Docker for Commerce does not require PHP and Composer to be installed locally.
- Local development with Cloud Docker in the Adobe Developer site
- Docker architecture and common commands
- Cloud Docker release notes