容器与云原生 / 系统课时

配置环境变量

配置环境变量

本课将区分 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:

text
ALPINE_TAG=3.20
APP_MODE=test

创建 app.env:

text
APP_NAME=compose-demo
LOG_LEVEL=info

创建 compose.yaml:

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 提前插值。

检查插值结果

执行:

bash
docker compose config

预期结果

text
解析后的镜像为 alpine:3.20,容器环境包含 APP_NAME=compose-demo、APP_MODE=test、LOG_LEVEL=debug。

docker compose config 会解析变量并显示合并后的应用模型,具体字段顺序可能随 Compose 版本变化。

运行并验证容器环境

执行:

bash
docker compose up

预期输出

text
app-1  | APP_NAME=compose-demo
app-1  | APP_MODE=test
app-1  | LOG_LEVEL=debug
app-1 exited with code 0

项目名前缀可能不同。若要临时切换插值文件,先创建 .env.prod:

text
ALPINE_TAG=3.21
APP_MODE=prod

再执行:

bash
docker compose --env-file .env.prod config

预期结果

text
解析后的镜像为 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 插值变量

bash
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。当多个来源都有同一个键时,逐层撤掉覆盖项可以定位值的来源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置环境变量

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通