容器与云原生 / 系统课时
管理环境变量与配置
管理环境变量与配置
本课学习如何在 Docker Compose 中管理应用配置,通过 env_file、environment 和变量插值控制不同环境的参数来源,同时避免将数据库密码等敏感信息直接提交到代码仓库。
学习目标
- 理解 Compose 中环境变量的来源和优先级关系。
- 掌握 env_file、environment 与变量插值的使用方式。
- 能够设计不暴露密钥的配置管理方案。
理解 Compose 配置来源
Docker Compose 支持多种方式向容器注入配置。常见来源包括宿主机环境变量、项目目录中的 .env 文件、Compose 文件中的 environment 字段,以及独立的 env_file 文件。
这些配置最终会成为容器进程启动时可以读取的环境变量。应用程序通常通过环境变量读取数据库地址、端口、运行模式和第三方服务凭据。
使用 env_file 管理环境文件
env_file 适合保存一组环境变量定义,可以将开发、测试和生产环境拆分为不同文件。
yaml
services:
api:
image: example/api:<TAG>
env_file:
- ./config/app.env
ports:
- "<PORT>:8080"预期结果
text
容器启动后,api 服务进程可以读取 app.env 中定义的环境变量。例如 app.env 可以保存非代码配置:
text
APP_ENV=development
DB_HOST=mysql
DB_PORT=3306预期结果
text
应用读取 APP_ENV、DB_HOST 和 DB_PORT 等配置值。生产环境中不要把包含密码的文件直接提交到 Git,应通过安全存储或部署系统注入敏感变量。
使用 environment 覆盖指定变量
environment 用于在 Compose 文件中显式声明变量,也可以覆盖 env_file 中同名变量。
yaml
services:
api:
image: example/api:<TAG>
env_file:
- ./config/app.env
environment:
APP_ENV: production
LOG_LEVEL: info预期结果
text
容器中的 APP_ENV 值为 production,LOG_LEVEL 值为 info。当团队需要明确展示关键运行参数时,可以使用 environment;当配置项较多时,通常使用 env_file 保持 Compose 文件简洁。
掌握变量插值规则
Compose 文件支持使用 ${变量名} 读取宿主机环境变量或 .env 文件中的值。
yaml
services:
web:
image: "example/web:${VERSION}"
ports:
- "${HTTP_PORT}:80"预期结果
text
VERSION=1.2.0 和 HTTP_PORT=<PORT> 被替换后生成实际配置。变量不存在时,可以使用默认值避免启动失败:
yaml
services:
web:
image: "example/web:${VERSION:-latest}"预期结果
text
未设置 VERSION 时,Compose 使用 latest 作为镜像标签。配置优先级与安全边界
实际排查配置问题时,需要先确认变量最终进入容器的结果,而不是只查看某一个配置文件。
bash
docker compose config预期结果
text
输出展开后的 Compose 配置,显示变量替换后的最终内容。通常需要遵循以下原则:
- 开发默认值可以放入
.env。 - 环境差异配置使用独立
env_file。 - 密钥不要写入镜像、Compose 文件或公开仓库。
- 生产环境优先使用专用密钥管理方案。
按自己的节奏,确认真正理解。