容器与云原生 / 系统课时

用 -e 传入环境变量

用 -e 传入环境变量

docker run 的 -e 选项可以在创建容器时写入环境变量,常用于传递环境名称、应用监听端口和外部服务地址。本课通过一个可执行示例说明多变量写法、宿主机变量转发方式,以及配置何时真正生效。

学习目标

  • 掌握 -e KEY=VALUE 的基本写法
  • 能一次向容器传入多个环境变量并验证结果
  • 理解宿主机变量、容器变量和应用读取之间的边界

-e 在容器创建时写入变量

每个 -e 负责一个环境变量,例如 -e APP_ENV=staging。需要多个变量时可以重复使用 -e。这些值会进入新容器的环境,容器内启动的进程可以按普通操作系统环境变量读取它们。

-e 不会修改镜像本身,也不会自动改写应用配置文件。应用必须主动读取对应变量,或使用支持环境变量绑定的配置框架,变量才会影响程序行为。

一次传入多个变量

下面用 Alpine 容器读取 APP_ENV 和 APP_PORT。若本机尚无 alpine:3.20,第一次执行可能先出现镜像拉取日志。

bash
docker run --rm -e APP_ENV=staging -e APP_PORT=8080 alpine:3.20 sh -c 'printf "env=%s port=%s\n" "$APP_ENV" "$APP_PORT"'

预期输出

text
env=staging port=8080

这里的 8080 只是容器进程读取到的变量值,不等于 Docker 已经发布了端口。若应用确实监听 8080 且需要从宿主机访问,还要另外使用 -p 配置端口映射。

从宿主机转发已有变量

如果只写 -e APP_ENV 而不写等号和值,Docker 会尝试把当前宿主机环境中的 APP_ENV 传给容器。因此这种写法依赖启动 Docker 命令的 Shell 已经设置了该变量;脚本需要稳定结果时,通常显式写值或由部署系统统一注入更清楚。

容器创建后,宿主机再修改同名变量不会自动更新正在运行的容器。要让新值生效,应以新配置重新创建容器,而不是期待运行中的进程同步宿主环境。

使用时注意边界

环境变量适合非敏感、需要按环境切换的运行配置,例如 APP_ENV、LOG_LEVEL、服务地址和应用内部端口。对于密码、访问令牌等敏感值,不要因为 -e 使用方便就把明文长期写进命令历史、脚本或流水线日志。

排查“变量没生效”时,先确认变量确实传入了容器,再确认应用读取的变量名完全一致,最后检查应用是否只在启动阶段加载配置。把这三个层次分开,可以避免把 Docker 注入问题和应用自身配置问题混在一起。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 -e 传入环境变量

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

登录哪都通