Projects have 3 default configs: dev, stg, and prd. You can think of these configs as the master branch for their respective environments, where all future configs branch off of. There are many reasons why you may want to create a branched config such as:
- Dedicated configs for each cloud deployment (AWS, GCP, Azure, etc..)
- Development of a new feature that requires additional secrets not yet released
- Securely sharing a branched config by sharing the name with a coworker
- Easy promotion of those change by adding them to Root Configs
- Extensive audit logging and versioning
Creating a branched config is fast. To get started, go to a project and then click on the + button under the environment name. This will open up a modal to provide a name for the config which will be prefixed with the environment name.
When working on large complex features, you may need a branched config during development that your team can share. Sharing a config is fast and secure, all your peers need to get started is the name of the config.
Let's walk through an example. Your peer Tim is working on your new billing system which adds support for Stripe. To do so he creates a new config either in the dashboard or in the CLI.
doppler configs create dev_stripe_billing
Now that the config is created, he will set the
dev_stripe_billing config as his primary for the current directory. Now when he calls commands in the future, the Doppler CLI will automatically use the
dev_stripe_billing when he is in that directory.
doppler configure set config=dev_stripe_billing
Tim is ready to start integrating Stripe so he adds their API key to the config's secrets.
doppler secrets set STRIPE_API_KEY=sk_test_9YxLnoLDdvOPn2dfjBVPB
Great! We now have a config with the newly Stripe API key added. From here on he can share the branched config with the rest of the team. If a team member wanted to test out that config they can pass the config name in on the run command.
doppler run -c dev_stripe_billing -- ./your-command-here
And that's it! When the feature is ready to be rolled out to master, they can add the Stripe API key to Root Configs and delete the feature branch config.
# Add secret to Development Root Config doppler secrets set -c dev STRIPE_API_KEY=sk_test_9YxLnoLDdvOPn2dfjBVPB # Add secret to Staging Root Config doppler secrets set -c stg STRIPE_API_KEY=sk_test_9YxLnoLDdvOPn2dfjBVPB # Add secret to Production Root Config doppler secrets set -c prd STRIPE_API_KEY=sk_live_SinMsVYhdHurkdOrVKWCd # Delete branched config doppler configs delete dev_stripe_billing
Updated 2 months ago