Environment

The environment block lets you refine the Couper configuration based on the set environment.

Block name	Context	Label	Nested block(s)
environment	Overall.	⚠ required, multiple labels are supported.	All configuration blocks of Couper.

The environment block works like a preprocessor. If the label of an environment block does not match the set COUPER_ENVIRONMENT value, the preprocessor removes this block and its content. Otherwise, the content of the block is added to the configuration.

Starting Couper with a configuration containing environment blocks will fail, if COUPER_ENVIRONMENT is missing or empty. A default value can be set using the settings block.

Example

Considering the following configuration with the COUPER_ENVIRONMENT value set to prod

server {
  api "protected" {
    endpoint "/secure" {
      environment "prod" {
        access_control = ["jwt"]
      }

      proxy {
        environment "prod" {
          url = "https://protected-resource.org"
        }
        environment "stage" {
          url = "https://test-resource.org"
        }
      }
    }
  }
}

the result will be:

server {
  api "protected" {
    endpoint "/secure" {
      access_control = ["jwt"]

      proxy {
        url = "https://protected-resource.org"
      }
    }
  }
}