容器与云原生 / 系统课时
通过环境变量注入运行参数
通过环境变量注入运行参数
同一份镜像常常要运行在开发、测试和生产环境中。把端口、环境名称和外部服务地址放到环境变量里,可以让镜像保持不变,只在启动容器时注入差异化参数。
学习目标
- 理解环境变量为什么适合承载运行时配置
- 会用
docker run -e向容器注入参数 - 能区分应用配置与 Docker 端口映射
把运行参数留到容器启动时
镜像负责封装程序和依赖,环境变量负责提供“这一次运行应该使用什么值”。Docker 只负责把键值放进容器进程环境,应用本身仍然必须主动读取这些变量;如果程序从未读取 APP_PORT,设置它不会自动改变监听端口。
下面用 Alpine 容器直接读取三个变量,验证注入行为:
bash
docker run --rm --name config-demo \
-e APP_PORT=8080 \
-e APP_ENV=production \
-e API_BASE_URL=http://api:9000 \
alpine:3.20 \
sh -c 'printenv APP_PORT; printenv APP_ENV; printenv API_BASE_URL'预期输出(首次运行若本地没有镜像,前面可能额外出现镜像拉取日志):
text
8080
production
http://api:9000--rm 表示进程退出后自动删除容器,-e KEY=value 则把一个变量传入容器。真正部署 Web 应用时,可以用同样方式传入数据库地址、日志级别或功能开关,但变量名必须与应用实际读取的配置项一致。
成组参数用 env-file 管理
当变量很多时,逐个写 -e 容易漏项,可以把非敏感配置写入 app.env。这是配置片段,文件内容本身不会启动容器:
text
APP_PORT=8080
APP_ENV=staging
API_BASE_URL=http://api:9000启动时改用 --env-file app.env 即可一次注入这些值。验证方法仍然是让应用打印或暴露最终配置,确认容器内读到的值与文件一致。不要把 export APP_PORT=8080 这类 Shell 语法直接写进 env-file;Docker 期望的是 KEY=value 形式。
环境变量不等于端口映射
APP_PORT=8080 是传给应用的配置,而 -p 8080:8080 是 Docker 的宿主机到容器端口映射,两者解决的问题不同。应用必须先在容器内监听对应端口;只有需要从宿主机或容器外访问时,才需要发布端口。
把环境差异放到运行时后,镜像可以在多个环境复用。需要调整配置时,只需重新创建容器并注入新值,而不必为了修改一个地址或环境名称重新构建镜像。
按自己的节奏,确认真正理解。