Flipt v2 supports the ability to configure multiple environments, allowing the user to switch between them in the UI as well as at evaluation time.

Environments are unique to other Flipt resources in that they are not created or managed via the Flipt API or UI. Instead, they are defined in the Flipt server configuration file as they are tightly coupled to the storage configuration.

​
Identifiers

Each environment has an identifier that is used to reference the environment in the configuration and in the UI/API and is used to determine the environment that will be used when evaluating flags.

Identifiers can be any string value but must be unique. Flipt creates a default identifier and environment for you automatically if you don’t specify one.

environments:
  local: # id
    name: "local"
    default: true

  staging: # id
    name: "staging"
    storage: "staging"

​
Storage

Each environment has a storage configuration field that is used to determine the storage backend that will be used for the environment.

The storage configuration is a reference to the storage backend that will be used for the environment.

environments:
  local:
    storage: "local"

In the above configuration, the local environment will use the local storage backend as defined in the storage configuration.

This mapping between environments and storage backends means that multiple environments can share the same storage backend.

For example you could have all environments share the same storage which syncs to a single git repository.

​
Directories

Each environment has an optional directory configuration field that is used to determine the directory that will be used to store the environment’s resources.

This is only required if multiple environments share the same storage backend, as Flipt needs to know where to ultimately store the state without conflicting with other environments.

environments:
  foo:
    directory: "foo"
    storage: "local"
  bar:
    directory: "bar"
    storage: "local"

In the above configuration, the foo and bar environments will use the same local storage backend but will store their resources in different directories.

​
Default

Each environment has a default configuration field that is used to determine if the environment is the default environment.

The default environment is the environment that will be used when no other environment is specified.

environments:
  local:
    default: true

This means that if no environment is specified when performing actions such as flag evaluation, creation, or updates, the local environment will be used. This will also be the environment that is selected in the UI by default.

​
Branching

You can create branches from an existing environment. Branches are a complete copy of the base environment and are completely independent of each other after creation.

Branches are created in the UI or API and do not require any additional configuration.

Branches can optionally be configured to sync to a remote Git repository. This allows you to create and track merge proposals for your branches if you have an SCM provider configured.

​
Source Control Management

Source Control Management is a paid enterprise feature and require an enterprise license.

Each environment can be configured to use a source control management provider. This allows you to go beyond just storing your environment’s data in a remote Git repository, but also create and track merge proposals for your branches.

environments:
  local:
    scm:
      type: "github"
      credentials: "github"
      api_url: "https://{your-github-enterprise-domain}/api/v3"

Environments can be configured to use a single Source Control Management (SCM) provider such as GitHub, GitLab, or Bitbucket.

As of the alpha release, only GitHub is supported, however we will be adding support for GitLab and Bitbucket soon.

​
Credentials

Configuring an SCM provider requires a set of credentials to be provided. These credentials are configured via the same mechanism as the remote storage credential configuration.

The identifier for the credentials is a string value that is used to reference the credentials in the configuration.

credentials:
  github:
    type: "basic"
    username: "{your-github-username}"
    password: "{your-github-access-token}"

​
API URL

The API URL is the URL of the SCM provider’s API. This is only required if you are using a self-hosted SCM provider such as GitHub Enterprise.

environments:
  local:
    scm:
      type: "github"
      credentials: "github"
      api_url: "https://{your-github-enterprise-domain}/api/v3"