Docker Compose 引用环境变量

在项目中，每每须要在 docker-compose.yml 文件中使用环境变量来控制不一样的条件和使用场景。本文集中介绍 docker compose 引用环境变量的方式。
说明：本文的演示环境为 ubuntu 16.04。

Compose CLI 与环境变量

Compose CLI(compose command-line 即 docker-compose 程序)可以识别名称为 COMPOSE_PROJECT_NAME 和 COMPOSE_FILE 等环境变量(具体支持的环境变量请参考这里)。好比咱们能够经过这两个环境变量为 docker-compose 指定 project 的名称和配置文件：

$ export COMPOSE_PROJECT_NAME=TestVar
$ export COMPOSE_FILE=~/projects/composecounter/docker-compose.yml

而后启动应用，显示的 project 名称都是咱们在环境变量中指定的：

若是设置了环境变量的同时又指定了命令行选项，那么会应用命令行选项的设置：

$ docker-compose -p nickproject up -d

在 compose file 中引用环境变量

咱们还能够在 compose file 中直接引用环境变量，好比下面的 demo：

version: '3'
  services:
    web:
      image: ${IMAGETAG}
      ports:
       - "5000:5000"
    redis:
      image: "redis:alpine"

咱们经过环境变量 ${IMAGETAG} 指定了 web 的镜像，下面经过 export 的方式来为 compose 配置文件中的环境变量传值：

注意，若是对应的环境变量没有被设置，那么 compose 就会把它替换为一个空字符串：

碰到这种状况，咱们能够在 compose 的配置文件中为该变量设置一个默认值：

version: '3'
services:
  web:
    image: ${IMAGETAG:-defaultwebimage}
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine"

这样，若是没有设置 IMAGETAG 变量，就会应用 defaultwebimage：

除了这种方式，咱们还能够经过后面将介绍的 .env 文件来为环境变量设置默认值。

把环境变量传递给容器

先来看一下在 compose file 中如何为容器设置环境变量：

web:
  environment: DEBUG: 1

compose file 中的 environment 节点用来为容器设置环境变量，上面的写法等同于：

$ docker run -e DEBUG=1

要把当前 shell 环境变量的值传递给容器的环境变量也很简单，去掉上面代码中的赋值部分就能够了：

web:
  environment: DEBUG:

这种状况下，若是没有在当前的 shell 中导出环境变量 DEBUG，compose file 中会把它解释为 null：

在试试导出环境变量 DEBUG 的状况：

$ export DEBUG=1

这才是咱们设计的正确的使用场景！

使用文件为容器设置多个环境变量

若是以为经过 environment 为容器设置环境变量不够过瘾，咱们还能够像 docker -run 的 --env-file 参数同样经过文件为容器设置环境变量：

web:
  env_file:
    - web-variables.env

注意，web-variables.env 文件的路径是相对于 docker-compose.yml 文件的相对路径。上面的代码效果与下面的代码相同：

$ docker run --env-file=web-variables.env

web-variables.env 文件中能够定义一个或多个环境变量：

# define web container env
APPNAME=helloworld
AUTHOR=Nick Li
VERSION=1.0

检查下结果：

原来 compose 把 env_file 的设置翻译成了 environment！

.env 文件

当咱们在 docker-compose.yml 文件中引用了大量的环境变量时，对每一个环境变量都设置默认值将是繁琐的，而且也会影响 docker-compose.yml 简洁程度。此时咱们能够经过 .env 文件来为 docker-compose.yml 文件引用的全部环境变量设置默认值！
修改 docker-compose.yml 文件的内容以下：

version: '3'
services:
  web:
    image: ${IMAGETAG}                 
    environment:
      APPNAME:
      AUTHOR:
      VERSION:
    ports:
     - "5000:5000"
  redis:
    image: "redis:alpine"

而后在相同的目录下建立 .env 文件，编辑其内容以下：

# define env var default value.
IMAGETAG=defaultwebimage
APPNAME=default app name
AUTHOR=default author name
VERSION=default version is 1.0

检查下结果，此时全部的环境变量都显示为 .env 文件中定义的默认值：

配置不一样场景下的环境变量

从前面的部分中咱们能够看到，docker compose 提供了足够的灵活性来让咱们设置 docker-compose.yml 文件中引用的环境变量，它们的优先级以下：

1. Compose file
2. Shell environment variables
3. Environment file
4. Dockerfile
5. Variable is not defined

首先，在 docker-compose.yml 文件中直接设置的值优先级是最高的。
而后是在当前 shell 中 export 的环境变量值。
接下来是在环境变量文件中定义的值。
再接下来是在 Dockerfile 中定义的值。
最后尚未找到相关的环境变量就认为该环境变量没有被定义。

根据上面的优先级定义，咱们能够把不一样场景下的环境变量定义在不一样的 shell 脚本中并导出，而后在执行 docker-compose 命令前先执行 source 命令把 shell 脚本中定义的环境变量导出到当前的 shell 中。经过这样的方式能够减小维护环境变量的地方，下面的例子中咱们分别在 docker-compose.yml 文件所在的目录建立 test.sh 和 prod.sh，test.sh 的内容以下：

#!/bin/bash
# define env var default value.
export IMAGETAG=web:v1
export APPNAME=HelloWorld
export AUTHOR=Nick Li
export VERSION=1.0

prod.sh 的内容以下：

#!/bin/bash
# define env var default value.
export IMAGETAG=webpord:v1
export APPNAME=HelloWorldProd
export AUTHOR=Nick Li
export VERSION=1.0LTS

在测试环境下，执行下面的命令：

$ source test.sh
$ docker-compose config

此时 docker-compose.yml 中的环境变量应用的都是测试环境相关的设置。

而在生产环境下，执行下面的命令：

$ source prod.sh
$ docker-compose config

此时 docker-compose.yml 中的环境变量应用的都是生产环境相关的设置。

总结

docker compose 对环境变量的使用提供了很是丰富支持和灵活的使用方式。但愿经过本文的总结能够帮助你们理清相关的用法，并可以以简洁的方式为不一样的使用场景提供支持。

参考：
Compose CLI environment variables
Environment variables in Compose
Compose file variable substitution
Declare default environment variables in file