To dramatically reduce maintenance downtime and provide efficient configuration of your store across environments, Adobe Commerce on cloud infrastructure provides the Configuration Management feature. For Adobe Commerce on cloud infrastructure 2.2.x and later implementations, this feature supports Pipeline Deployment concepts and options with reduced steps.
The painful and time-consuming issues of deploying your web store include:
- Applying the same configuration across all environments. Normally, you would enter configurations manually or through complicated database updates. With Configuration Management, you export configurations from the database into a single file to later push it with your code from your local development environment to Integration, Staging, and Production.
- Site downtime when deploying static content. Typically, static content is deployed during the deploy phase. This can take up to 30 minutes or more, which is not acceptable for business. Configuration Management moves static content deployment to the build phase, which does not require downtime.
- Adobe Commerce on cloud infrastructure 2.1.4 and later for Configuration Management
- Adobe Commerce on cloud infrastructure 2.2 and later for Configuration Management/Pipeline Deployment
What is Configuration Management
To make a long story short, the Configuration Management (also known as Pipeline Deployment) process extracts all configuration settings from your Adobe Commerce on cloud infrastructure implementation (database) into a single PHP file. Then, you add the file to your Git commit and push it across all of your environments.
This provides the following benefits:
- Consistent settings in all environments: any settings being exported to the configuration file become locked (the corresponding fields in the Commerce Admin become read-only), which ensures consistent configurations as you push the file across all your environments.
- Reduced downtime: the static file deployment shifts from the deploy phase (which requires the site to be in the Maintenance mode) to the build phase (when the site is not in Maintenance mode and will not be brought down if errors or issues occur).
- Protected sensitive data: with Adobe Commerce on cloud infrastructure 2.2 and later, the process also exports any sensitive data (for example, payment gateway credentials) to the
env.phpfile. This file should only be saved to the environment it is created in and not pushed with your Git branches.
We strongly recommend applying the Configuration Management approach in your deployment.
Configuration Management in our developer documentation
- Configuration management for 2.1.X and the example in the Adobe Commerce on cloud infrastructure Guide
- Configuration management for 2.2.X and the example in the Adobe Commerce on cloud infrastructure Guide
- Upgrade from 2.0.X or 2.1.X section of the Upgrade Adobe Commerce on cloud infrastructure topic
- Pipeline Deployment in the Adobe Commerce on cloud infrastructure Configuration Guide — For Adobe Commerce on cloud infrastructure, you do not need to follow the instructions in this guide. The content is strictly for reference. We already provide the build server, integration environments, and more with Adobe Commerce on cloud infrastructure.