Protect Configuration
Introduction
Since resources are created according to the configurations you enter, it's essential to restrict such configurations from direct modifications. For critical environments like production, it becomes necessary to introduce an approval flow for any edits made to the configuration files.
In Devtron, these configurations are present in the App Configuration tab of your application.
Any changes made to the following configurations will require approval if enabled:
Deployment Template
ConfigMaps
Secrets
This stands true for both: base configuration and respective environment-level configuration.
![](https://docs.devtron.ai/~gitbook/image?url=https%3A%2F%2Fdevtron-public-asset.s3.us-east-2.amazonaws.com%2Fimages%2Fcreating-application%2Fconfig-approval%2Fbase-config.jpg&width=768&dpr=4&quality=100&sign=cad0da5&sv=1)
![](https://docs.devtron.ai/~gitbook/image?url=https%3A%2F%2Fdevtron-public-asset.s3.us-east-2.amazonaws.com%2Fimages%2Fcreating-application%2Fconfig-approval%2Fenv-config.jpg&width=768&dpr=4&quality=100&sign=4490b763&sv=1)
Tutorial
Changing the Configuration Values
Only a super-admin, manager, and admin can edit the configuration values.
Let's assume you are the application admin and you wish to edit the deployment template of your environment (as an override).
Go to the
App Configuration
tab.In Environment Overrides → (choose your environment) → Deployment Template
Figure 2: Selecting Values to Change You can change the value of a key to a desired value as shown below. Once done, click the Save Changes… button.
Figure 3: Changed Values
If you are not a super-admin, you cannot modify the locked keys in deployment template. Refer Lock Deployment Configuration to know more.
If the configuration is protected, your changes won't be published right away. You can do either of the following:
Save as draft : Selecting this option will save your file as a draft. You and other users can view and edit the saved draft and propose it further for approval.
Save & Propose Changes : Selecting this option will propose your changes to a configuration approver for a review.
Since we are proposing the changes immediately, click Propose Changes.
Figure 4: Proposing Changes You can also view the approver(s) if you wish.
Figure 5: Viewing the Approver(s)
The one who performs the edits cannot approve their own changes. A different user has to review and approve.
Only one draft can exist at time and you cannot create multiple drafts. In the top-right corner, you have the option to discard the draft if you don't wish to proceed with the edits you made.
Approving the Configuration
Only a different super-admin user or someone (who is not amongst the editors of the draft), having Configuration approver
access, can approve the changes made to the configuration files.
Go to the edited configuration file to review and approve the changes as shown below.
![](https://docs.devtron.ai/~gitbook/image?url=https%3A%2F%2Fdevtron-public-asset.s3.us-east-2.amazonaws.com%2Fimages%2Fcreating-application%2Fconfig-approval%2Fapproval-screen.jpg&width=768&dpr=4&quality=100&sign=7a9f5465&sv=1)
A super-admin can check whether a user has approval rights by going to Global Configurations → Authorization (dropdown) → User Permissions.
![](https://docs.devtron.ai/~gitbook/image?url=https%3A%2F%2Fdevtron-public-asset.s3.us-east-2.amazonaws.com%2Fimages%2Fcreating-application%2Fconfig-approval%2Fconfig-approver-1.jpg&width=768&dpr=4&quality=100&sign=f202b03d&sv=1)
Deploying with New Configuration Values
Once the approver validates and approves your configuration changes, you can proceed to deploy your application with the updated configuration.
Go to the Build & Deploy tab of your application.
Click Select Image in the deployment flow.
Figure 8: Build & Deploy Page You can view an indicator at the bottom
Config Diff from Last Deployed
. Click Review to view the changes.Figure 9: Checking Config Diff
If the new configuration is not yet approved, the changes made to the config would not be visible during deployment, it would show No Config Diff from Last Deployed
at the bottom. In that case, check whether your changes are present in the live config or not. If your changes are absent, chances are your draft is either pending for approval or rejected (discarded).
Once you have verified the changes, you can click Deploy.
Figure 10: Deploying App using New Config
If you don't wish to deploy with the new changes, you can choose Last deployed config
from the available drop-down.
Enabling/Disabling Config Protection
Only a super-admin can enable or disable the config protection.
Go to the
App Configuration
tab.Click
Protect Configuration
.Use the toggle button to enable the protection for the configuration of your choice (base/environment level). A protection badge would appear next to the chosen configuration.
Alternatively, unprotecting the configuration will lead to the discarding of unapproved drafts (if any).
![](https://docs.devtron.ai/~gitbook/image?url=https%3A%2F%2Fdevtron-public-asset.s3.us-east-2.amazonaws.com%2Fimages%2Fcreating-application%2Fconfig-approval%2Ftoggle-protection.jpg&width=768&dpr=4&quality=100&sign=48084c9f&sv=1)
Last updated