容器与云原生 / 系统课时

传入环境变量

传入环境变量

本课解决容器启动时如何接收外部配置的问题。你将分别使用 -e 和 --env-file 传入变量,理解覆盖规则,并掌握避免把密码、令牌直接暴露在命令历史中的基本做法。

学习目标

  • 使用单个参数和环境文件向容器传值
  • 验证容器进程实际读取到的变量
  • 区分普通配置与敏感信息的处理方式

选择传入方式

少量临时配置适合使用 -e KEY=value,命令短且直观;变量较多、需要重复启动时,更适合写入环境文件并通过 --env-file 加载。两种方式都只在创建容器时生效,修改宿主机变量或环境文件不会自动更新已经运行的容器。

-e KEY 不写值时,Docker 会尝试继承当前终端中的同名环境变量。为了避免因终端环境不同而产生隐式差异,生产脚本通常显式写值,或统一使用受版本管理约束的配置模板。

使用单个变量和环境文件

下面先用 -e 传入一个变量,再创建环境文件传入两个变量。环境文件每行使用 KEY=value,等号两侧不要添加多余空格。

bash
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

预期输出:

text
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 机制

下一课预告

下一课将把容器内部端口发布到宿主机,并区分监听地址、固定端口、端口范围与自动分配方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

传入环境变量

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

登录哪都通