Deployment process
The deployment process begins when you perform a merge, push, or synchronization of your environment, or when you trigger a manual redeployment. The deployment process takes time, but there are ways to optimize deployment that depend on whether you are developing and testing or working with a live site. Most notably, you can control the static content deployment.
There are three, distinct phases of the deployment process: build, deploy, and post-deploy. Each phase performs specific actions with limited resources:
Build phase
The build phase assembles containers for the services defined in the configuration files, installs dependencies based on the composer.lock
file, and runs the build hooks defined in the .magento.app.yaml
file. Without the ability to connect to any services or access the database, the build phase depends on the resources limited to the environment.
Deploy phase
The deploy phase places a temporary hold on incoming requests and transitions the site to maintenance mode. The deploy phase uses the new containers and, after mounting the file system, opens network connections, activates the services defined in the relationships
section of the .magento.app.yaml
file, and runs the deploy hooks defined in the .magento.app.yaml
file. Everything is read only, except for directories defined in the .magento.app.yaml
file. By default, the mounts
property includes the following directories:
app/etc
—contains theenv.php
andconfig.php
configuration filespub/media
—contains all media data, such as products or categoriespub/static
—contains generated static filesvar
—contains temporary files created during runtime
All other directories have read-only permissions. The new site becomes active at the end of the deploy phase as it transitions out of maintenance mode and releases the temporary hold on incoming requests.
In deploy phase, copies of the app/etc/config.php
and app/etc/env.php
deployment configuration files are saved with the BAK extension. See Store settings to learn about restoring these files.
Post-deploy phase
The post-deploy phase runs the post-deploy hooks defined in the .magento.app.yaml
file. Performing any action on this phase can affect site performance; however, you can use the WARM_UP_PAGES environment variable to populate the cache.
Verify configurations
You can test the optimal configuration for the state of your project by running the Smart wizards.
ece-tools
2002.1.0 and later, you can use the scenario-based deployment feature to customize the build, deploy, and post-deploy processes for your Adobe Commerce on cloud infrastructure project. See Scenario-based deployment.