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.php file. 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.Xand the example in the Adobe Commerce on cloud infrastructure Guide
  • Configuration management for 2.2.Xand 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.
Previous pageLog locations (directories) for Starter plan
Next pageHow to add a new country to Adobe Commerce

Commerce


Connect with Experience League at Summit!

Get front-row access to top sessions, hands-on activities, and networking—wherever you are!

Learn more