How do I inject environment specific configuration?

Each environment in Jenkins X is defined in a git repository; we use GitOps to manage all changes in each environment such as:

  • adding/removing apps
  • changing the version of an app (up or down)
  • configuring any app with environment specific values

The first two items are defined in the env/requirements.yaml file in the git repository for your environment. the latter is defined in the env/values.yaml file.

Helm charts use a values.yaml file so that you can override any configuration inside your Chart to modify settings such as labels or annotations on any resource or configurations of resources (e.g. replicaCount ) or to pass in things like environment variables into a Deployment .

So if you wish to change, say, the replicaCount of an app foo in Staging then find the git repository for the Staging environment via jx get env to find the git URL.

Navigate to the env/values.yaml file and add/edit a bit of YAML like this:

foo:
  replicaCount: 5

Submit that change as a Pull Request so it can go through the CI tests and any peer review/approval required; then when its merged it master it will modify the replicaCount of the foo application (assuming there’s a chart called foo in the env/requirements.yaml file)

You can use vanilla helm to do things like injecting the current namespace if you need that.

To see a more complex example of how you can use a values.yaml file to inject into charts, see how we use these files to configure Jenkins X itself.