容器与云原生 / 系统课时
配置环境变量
配置环境变量
本课将区分 Compose 插值变量与容器环境变量,并组合使用 .env、env_file 和 environment。完成后,你可以在不修改主配置文件的情况下切换镜像版本和运行参数。
学习目标
- 区分配置插值与容器环境变量
- 使用
environment、env_file和.env - 通过
docker compose config验证最终生效值
三种配置来源
.env 主要为 Compose 文件中的 ${VAR} 提供插值值;env_file 把文件中的键值注入容器;environment 直接声明容器环境变量,并会覆盖 env_file 中的同名值。官方文档明确说明,服务的 environment 值优先于 env_file。
| 方式 | 作用位置 | 典型用途 |
|---|---|---|
.env |
Compose 解析阶段 | 镜像标签、端口、文件路径 |
env_file |
容器运行环境 | 批量应用配置 |
environment |
容器运行环境 | 少量显式值或覆盖值 |
创建完整示例
创建 .env:
ALPINE_TAG=3.20
APP_MODE=test创建 app.env:
APP_NAME=compose-demo
LOG_LEVEL=info创建 compose.yaml:
services:
app:
image: "alpine:${ALPINE_TAG:-3.20}"
env_file:
- app.env
environment:
APP_MODE: "${APP_MODE:-dev}"
LOG_LEVEL: debug
command:
- sh
- -c
- |
printf 'APP_NAME=%s\n' "$$APP_NAME"
printf 'APP_MODE=%s\n' "$$APP_MODE"
printf 'LOG_LEVEL=%s\n' "$$LOG_LEVEL"这里的 ${ALPINE_TAG} 和 ${APP_MODE} 先由 Compose 插值;APP_NAME 来自 app.env;LOG_LEVEL 在两个位置都有定义,因此最终使用 environment 中的 debug。命令中的 两个连续的美元符号 会向容器保留一个 $,避免 Compose 提前插值。
检查插值结果
执行:
docker compose config预期结果
解析后的镜像为 alpine:3.20,容器环境包含 APP_NAME=compose-demo、APP_MODE=test、LOG_LEVEL=debug。docker compose config 会解析变量并显示合并后的应用模型,具体字段顺序可能随 Compose 版本变化。
运行并验证容器环境
执行:
docker compose up预期输出
app-1 | APP_NAME=compose-demo
app-1 | APP_MODE=test
app-1 | LOG_LEVEL=debug
app-1 exited with code 0项目名前缀可能不同。若要临时切换插值文件,先创建 .env.prod:
ALPINE_TAG=3.21
APP_MODE=prod再执行:
docker compose --env-file .env.prod config预期结果
解析后的镜像为 alpine:3.21,APP_MODE 的值为 prod。不要把密码、令牌等敏感信息提交到普通 .env 文件。生产环境应结合密钥管理能力,并通过 docker compose config 检查输出中是否意外暴露敏感值。
常见混淆
.env 中出现变量,不代表它会自动进入容器;只有该变量被 environment 引用,或通过 env_file 等方式注入时,容器才能读取。反过来,env_file 注入容器的变量也不会自动参与 Compose 文件插值。
比较配置值和实际运行值
先运行 docker compose config --environment,检查 Compose 解析文件时用到的值。如果 APP_MODE 和 .env 不一致,优先检查当前终端是否已经设置了同名变量。这个命令只用于看插值输入,容器实际收到的值可以用应用输出验证。Compose 插值变量
docker compose run --rm app
docker compose run --rm -e APP_MODE=one-off app在终端未设置同名变量且使用本课 .env 的情况下,第一次输出 APP_MODE=test,第二次输出 APP_MODE=one-off。这两次的 APP_NAME 都来自 app.env,LOG_LEVEL 都由服务的 environment 覆盖为 debug。单次运行的 -e 覆盖只影响这次启动的容器。Compose 环境变量优先级
再删除 compose.yaml 中的 LOG_LEVEL: debug 并重复第一条命令,预期 LOG_LEVEL 恢复成 info。当多个来源都有同一个键时,逐层撤掉覆盖项可以定位值的来源。