Environment variables

How to create and manage environment variables for a particular environment

When you create an environment, Release creates an environment configuration and environment variables specific to the environment. The environment-specific configuration and environment-specific variables files that dictate an environment's behaviour can be found on the Environment Details page. Click the Edit button to modify the environment variables.

There is a single structural differences between the "Default Environment Variables" file and the environment-specific "Environment Variables" file:

• The "Default Environment Variables" file groups all the default environment variables in the defaults section.

• The environment-specific "Environment Variables" file detailes the environment variables that will be exposed to every container in the envs section.

You can import secrets from external secrets managers as environment variables. Find instructions in our secrets guide.

The mapping and services sections are the same in both files and will be carried over from the "Default Environment Variables" file to the "Environment Variables" file. You can edit and delete these sections in the "Environment Variables" file.

The schema for environment-specific environment variables is the same as the "Default Environment Variables" file.

Here's an example of a schema for environment-specific environment variables:

mapping:
  type: Hash
  description: Maps Release variables to your app's variables
  required: false
defaults:
  type: Array
  description: Default environment variables for your app
  required: true
services:
  type: Hash
  description: Service specific environment variables 
  required: false