容器与云原生 / 系统课时
传入环境变量
传入环境变量
本课解决容器启动时如何接收外部配置的问题。你将分别使用 -e 和 --env-file 传入变量,理解覆盖规则,并掌握避免把密码、令牌直接暴露在命令历史中的基本做法。
学习目标
- 使用单个参数和环境文件向容器传值
- 验证容器进程实际读取到的变量
- 区分普通配置与敏感信息的处理方式
选择传入方式
少量临时配置适合使用 -e KEY=value,命令短且直观;变量较多、需要重复启动时,更适合写入环境文件并通过 --env-file 加载。两种方式都只在创建容器时生效,修改宿主机变量或环境文件不会自动更新已经运行的容器。
-e KEY 不写值时,Docker 会尝试继承当前终端中的同名环境变量。为了避免因终端环境不同而产生隐式差异,生产脚本通常显式写值,或统一使用受版本管理约束的配置模板。
使用单个变量和环境文件
下面先用 -e 传入一个变量,再创建环境文件传入两个变量。环境文件每行使用 KEY=value,等号两侧不要添加多余空格。
docker run --rm \
-e APP_MODE=debug \
alpine:3.20 \
sh -c 'printf "APP_MODE=%s\n" "$APP_MODE"'
cat > app.env <<'EOF'
APP_MODE=production
APP_PORT=8080
EOF
docker run --rm \
--env-file app.env \
alpine:3.20 \
sh -c 'printf "APP_MODE=%s\nAPP_PORT=%s\n" "$APP_MODE" "$APP_PORT"'
rm -f app.env预期输出:
APP_MODE=debug
APP_MODE=production
APP_PORT=8080镜像首次使用时可能先出现拉取日志,但最终变量值应与上面的三行一致。--rm 会在进程退出后自动删除测试容器。
覆盖规则与变量边界
同一个变量同时来自镜像默认值、环境文件和 -e 参数时,启动命令中的显式 -e KEY=value 优先级更高。这个规则适合用环境文件保存通用配置,再用少量 -e 覆盖当前环境差异。
环境变量最终属于容器配置的一部分,可以通过容器检查命令或容器内进程读取。它适合端口、运行模式、功能开关等普通配置,但不等于安全的密钥存储方案。
避免暴露敏感值
不要把密码、访问令牌直接写在 docker run -e PASSWORD=... 中,因为命令可能进入 Shell 历史、审计日志或自动化平台记录。环境文件虽然避免了值直接出现在命令行中,但文件本身仍是明文,应限制权限、排除版本提交,并在使用后妥善清理。
真正的生产密钥应优先交给专用密钥管理服务、编排平台 Secret,或以只读文件挂载给应用。应用也应支持从文件读取敏感值,而不是只接受环境变量。
本课总结
- 少量临时变量使用
-e,成组配置使用--env-file - 环境变量在创建容器时确定,修改来源不会自动更新现有容器
- 环境文件仍是明文,敏感值应交给专用 Secret 机制
下一课预告
下一课将把容器内部端口发布到宿主机,并区分监听地址、固定端口、端口范围与自动分配方式。