容器与云原生 / 系统课时
environment 怎样传变量给容器
environment 怎样传变量给容器
应用镜像通常不应该把数据库地址、运行环境或功能开关写死。Compose 的 environment 可以在创建容器时把这些值写入进程环境,本课通过一个最小服务验证变量确实进入容器,并说明常见写法与覆盖规则。
学习目标
- 使用
environment为容器设置运行时环境变量 - 选择清晰的映射语法并正确处理字符串值
- 理解
environment、env_file与临时命令行覆盖之间的关系
用映射语法设置容器环境
environment 属于服务配置,Compose 创建容器时会把其中的键值写入容器环境。它支持映射和列表两种语法;在团队配置中,映射形式通常更容易审查,也更不容易把键和值看混。([Docker Documentation][2])
下面用 alpine 容器直接打印三个变量,不依赖额外应用代码。
mkdir -p compose-environment-demo
cd compose-environment-demo
cat > compose.yaml <<'EOF'
services:
app:
image: alpine:3.20
environment:
APP_ENV: "staging"
DB_HOST: "db.internal"
FEATURE_CHECKOUT: "true"
command:
- sh
- -c
- env | grep -E '^(APP_ENV|DB_HOST|FEATURE_CHECKOUT)=' | sort
EOF
docker compose run --rm app预期输出
APP_ENV=staging
DB_HOST=db.internal
FEATURE_CHECKOUT=true首次运行如果本机没有 alpine:3.20,Docker 可能先打印镜像或网络准备日志;上面的三行是容器命令最终应输出的变量值。
变量值可以来自哪里
environment 既可以直接写固定值,也可以结合 Compose 插值,例如 APP_ENV: "${APP_ENV:-development}"。前者适合稳定且非敏感的默认配置,后者适合让 Shell 或 .env 决定不同环境的值。
列表形式与映射形式都受支持,例如 - APP_ENV=staging 与 APP_ENV: "staging" 可以表达相同结果。映射形式在布尔值、数字和空值附近更直观;像 "true"、"8080" 这类希望应用按字符串读取的值,显式加引号更稳妥。([Docker Documentation][2])
还可以只写变量名而不写值,让 Compose 从运行 Compose 的 Shell 继承,例如列表中的 - APP_ENV。这种写法在 Shell 未定义变量时不会发出警告;如果希望缺失时更早暴露问题,更推荐显式使用 ${APP_ENV:?APP_ENV is required}。([Docker Documentation][2])
与 env_file 怎样配合
当变量很多时,可以把一组容器环境变量放到服务级 env_file;而少量关键覆盖值继续写在 environment 中。若同一个变量同时由 env_file 和 environment 设置,environment 的值优先。Docker 镜像中通过 ENV 声明的默认值,只有在 Compose 没有用更高优先级来源覆盖时才会生效。([Docker Documentation][3])
services:
app:
image: example/app:1.0
env_file:
- ./app.env
environment:
APP_ENV: "production"这是配置片段示例,依赖同目录中的 app.env 与实际存在的 example/app:1.0 镜像。生效后,APP_ENV 使用 environment 中的 production;其他未被覆盖的变量继续从 app.env 读取。可用 docker compose config 检查解析后的服务配置,再进入实际容器用 env 验证运行时值。
不要把环境变量当秘密存储
数据库主机名、运行模式、功能开关适合放进环境变量,但数据库密码、私钥、长期访问令牌不应因为“应用能从环境读取”就直接明文写进 compose.yaml。Docker 官方建议敏感信息使用 secrets 等更合适的机制。([Docker Documentation][2])
实际使用时,可以把 environment 看成容器启动时的“运行参数入口”:镜像保持通用,Compose 在部署现场提供具体值。只要同时明确变量来源、覆盖顺序和敏感信息边界,就能在不改镜像的情况下切换不同运行环境。