Create app configuration

Set up and manage base and environment-specific configuration for your microservice

Before you start

Platform service configuration is complex. Configuration can vary depending on the service type and the environment it runs in. Several files, stored in different repositories, control how your service behaves.

To understand how configuration works on MDTP, read the GitHub guidance about configuration file hierarchies.

Note: An environment-specific config file must be created for each environment where the service will run.

Create config files

  1. Go to the MDTP Catalogue and select your microservice.
  2. Under the Code section, select Commissioning State.
  3. In the table, find the App Config Base or App Config Environment row and select Add.
  4. Fill out the Create App Config form and select the environments you’ll be deploying to.
  5. Select Build to generate your config files.

What gets generated

  • You’ll get app-config files in the app-config-environments and app-config-base repositories.
  • The files will be rendered using settings from the create-app-configs Jenkins job.
  • If you’re using MongoDB, config files will contain a URI string — except in app-config-base.

Warning: Changes to app-config-base will be applied at the next deployment. You do not need to rebuild the slug.

Check your config files

  1. Go to the MDTP Catalogue and select your microservice.
  2. Under the Code section, select Commissioning State.

Need support?

Ask in #team-platops on Slack.

Got feedback?

We’re always improving our documentation. Share your feedback using the team channel above.