容器与云原生 / 系统课时
env_file 适合什么时候使用
env_file 适合什么时候使用
当一个服务需要几十个运行参数时,把它们全部写进 compose.yaml 会很难维护。本课用 env_file 把容器运行环境拆到独立文件,并明确它与 Compose 自身变量插值文件不是一回事。
学习目标
- 能用
env_file为服务批量注入容器环境变量 - 能判断
env_file、environment与.env分别解决什么问题 - 能验证变量最终是否进入容器以及覆盖顺序
用 env_file 管理容器运行参数
env_file 是服务级配置,它读取键值文件,并把其中的变量传入该服务容器。相对路径以 Compose 文件所在目录为基准;同一服务可以声明多个文件,后面的文件可覆盖前面的同名变量。若同时在 environment 中设置同名变量,则 environment 的值优先。Docker 官方文档对这些行为有明确说明。(Docker 服务配置参考)
假设应用需要环境名、日志级别和 API 地址,可以把运行参数放到 app.env:
APP_ENV=staging
LOG_LEVEL=debug
API_BASE_URL=https://api.example.com将 app.env 和下面的 compose.yaml 保存在同一个独立实验目录。示例要求 Compose 插件和可用的 Docker Engine;不依赖宿主机额外设置这些变量。
services:
app:
image: alpine:3.20
env_file:
- ./app.env
environment:
LOG_LEVEL: info
command:
- sh
- -c
- |
printf 'APP_ENV=%s\nLOG_LEVEL=%s\nAPI_BASE_URL=%s\n' "$$APP_ENV" "$$LOG_LEVEL" "$$API_BASE_URL"这里把 LOG_LEVEL 又写在 environment 中,是为了演示显式覆盖。命令中的 两个连续的美元符号 会让美元符号保留到容器内,再由容器中的 shell 读取环境变量,而不是提前被 Compose 插值。
运行服务:
docker compose run --rm app预期输出:
APP_ENV=staging
LOG_LEVEL=info
API_BASE_URL=https://api.example.com这说明 APP_ENV 和 API_BASE_URL 来自 app.env,而 LOG_LEVEL=info 覆盖了文件中的 debug。
不要把 env_file 当成 Compose 插值文件
env_file 的目标是设置容器运行时环境;Compose 文件里的 ${VAR} 则属于Compose 配置插值。默认 .env、宿主机 shell 环境以及通过 docker compose --env-file 指定的文件可以为这种插值提供值,而服务的 env_file 本身不是用来给 image: ${TAG} 这类字段提供变量的。Docker 文档也将这两类用途分开说明。(Compose 插值说明)
可以按下面的边界理解:
| 配置位置 | 主要用途 | 变量最终去哪 |
|---|---|---|
服务 env_file |
批量提供应用运行参数 | 容器环境 |
服务 environment |
少量显式设置或覆盖参数 | 容器环境 |
默认 .env / --env-file |
为 compose.yaml 中 ${VAR} 提供插值值 |
Compose 配置解析阶段 |
例如 app.env 中即使存在 APP_IMAGE=alpine:3.20,也不要据此期待 image: ${APP_IMAGE} 自动获得该值;若要用于 Compose 插值,应把变量放进插值来源,例如默认 .env,或在命令中使用 --env-file。
什么时候适合使用 env_file
当一组非敏感运行参数需要被一个或多个服务复用,或者不同环境需要维护不同参数文件时,env_file 很合适,例如 app.dev.env、app.test.env、app.prod.env。它能减少 YAML 中冗长的 environment 列表,同时保留清晰的覆盖入口。
如果参数只有两三个且只属于单个服务,直接写 environment 往往更清楚;如果变量是为了决定镜像标签、端口映射或其他 Compose 字段,则应使用 Compose 插值来源,而不是服务级 env_file。
修改 app.env 后要重新创建服务容器,单纯 restart 不会更新创建时传入的环境变量。可以先运行 docker compose config 检查合并结果,再运行上面的临时容器,核对输出是否真的变化;查看解析结果时应避免把含敏感参数的完整输出直接贴入公开日志。