详解Docker Compose 中可用的环境变量问题

compose 的多个部分在某种情况下处理环境变量。本教程可以帮助你找到所需的信息。

1. 替换compose文件中的环境变量

可以使用 shell 中的环境变量填充 compose 文件中的值：

web:
 image: "webapp:${tag}"

更多信息请参考 compose 文件手册中的 variable substitution 章节。

2. 设置容器中的环境变量

可以通过 environment 关键字设置服务容器中的环境变量，就跟使用 docker run -e variable=value ... 一样：

web:
 environment:
 - debug=1

3. 将环境变量传递到容器

在使用 environment 关键字时不赋值，就可以将 shell 中的环境变量传递给服务容器，就跟使用 docker run -e variable ... 一样：

web:
 environment:
 - debug

容器中的 debug 变量的值从运行 compose 的 shell 中的同名变量中获取。

4. “env_file”配置选项

可以通过 env_file 命令使用外部文件将多个环境变量传递到服务容器，就跟使用 docker run --env-file=file ... 一样：

web:
 env_file:
 - web-variables.env

5. 使用 ‘docker-compose run'设置环境变量

就像 docker run -e 命令一样，可以使用 docker-compose run -e 设置一次性容器上的环境变量：

docker-compose run -e debug=1 web python console.py

也可以通过从 shell 中传递一个变量，而不是直接赋值：

docker-compose run -e debug web python console.py

容器中的 debug 变量的值从运行 compose 的 shell 中的同名变量中获取。

6. “.env”文件

可以在名为 中为 compose 文件中引用的任何环境变量设置默认值，或者用于配置 compose：

$ cat .env
tag=v1.5

$ cat docker-compose.yml
version: '3'
services:
 web:
 image: "webapp:${tag}"

运行 docker-compose up 时，上面定义的 web 服务使用 webapp:v1.5 镜像。可以通过 将应用程序的配置信息打印到终端来验证：

$ docker-compose config

version: '3'
services:
 web:
 image: 'webapp:v1.5'

shell 中的值优先于 .env 文件中指定的值。如果在 shell 中将 tag 设置为不同的值，则镜像中将使用该值：

$ export tag=v2.0
$ docker-compose config

version: '3'
services:
 web:
 image: 'webapp:v2.0'

当在多个文件中设置相同的环境变量时，以下是 compose 用于选择要使用的值的优先级：

• compose 文件
• environment 文件
• dockerfile
• 变量未定义

在下面的例子中，我们在 environment 文件和 compose 文件上设置了相同的环境变量：

$ cat ./docker/api/api.env
node_env=test

$ cat docker-compose.yml
version: '3'
services:
 api:
 image: 'node:6-alpine'
 env_file:
  - ./docker/api/api.env
 environment:
  - node_env=production

运行容器时，在 compose 文件中定义的环境变量优先。

$ docker-compose exec api node

process.env.node_env
'production'

只有在 environment 或 env_file 没有 docker compose 条目时，dockerfile 中的任何 arg 或 env 设置才会评估（evaluate）。

nodejs 容器的细节

如果你有脚本的 package.json 条目像 node_env=test node server.js 一样启动，那么这将覆盖 docker-compose.yml 文件中的任何设置。

7. 使用环境变量配置 compose

有几个环境变量可用来配置 docker compose 命令行行为。它们以 compose_ 或 docker_ 开头，并记录在cli 环境变量中。

8. 通过 link 创建环境变量

在第一版 compose 文件中使用 选项时，会为每个链接创建环境变量。它们记录在 link环境变量参考 中。

但是，这些变量已被弃用。link 改为为主机创建别名。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。