容器与云原生 / 系统课时
注入生产配置与密钥
注入生产配置与密钥
生产环境中的配置和密钥不能写入镜像,也不能依赖开发环境文件。本课介绍如何在容器启动时注入配置来源,并通过校验与轮换机制降低泄露风险。
学习目标
- 理解环境变量、配置文件和密钥挂载的适用场景
- 掌握 Docker 运行时注入配置的方法
- 建立生产环境必填配置检查与密钥更新流程
选择合适的配置注入方式
容器镜像应该保持通用,环境差异通过运行时参数传递。普通配置可以使用环境变量或外部配置文件,数据库密码、令牌等敏感内容应使用专门的密钥管理方式,避免出现在镜像层、代码仓库或日志中。常见选择如下:
| 类型 | 推荐方式 | 适用内容 |
|---|---|---|
| 普通配置 | 环境变量、配置文件挂载 | 服务地址、运行模式、功能开关 |
| 敏感数据 | Docker secrets、密钥中心 | 密码、Token、私钥 |
| 大量配置 | 外部配置文件 | 多环境参数集合 |
使用环境变量注入运行参数
Docker 可以在启动容器时通过 -e 或 Compose 的 environment 注入变量。应用启动时读取变量,并根据缺失情况主动失败,而不是运行到异常位置才报错。
bash
docker run --rm \
-e APP_ENV=production \
-e DATABASE_HOST=<PATH> \
-e DATABASE_PASSWORD=<ID> \
my-service:latest预期结果
text
容器启动成功,应用读取 APP_ENV、DATABASE_HOST 和 DATABASE_PASSWORD。通过配置文件和密钥文件分离敏感信息
当配置数量增加时,可以将非敏感配置保存为文件,将密钥通过只读挂载提供给应用。应用只读取运行环境中的文件,不需要知道密钥来源。
yaml
services:
api:
image: my-service:latest
volumes:
- ./config:/app/config:ro
- ./secrets/db-password:/run/secrets/db-password:ro预期结果
text
容器内出现 /app/config 配置目录和只读密钥文件 /run/secrets/db-password。建立必填校验和轮换机制
生产应用启动阶段应该检查关键变量是否存在,例如数据库地址、签名密钥和外部服务凭据。发现缺失时立即退出,让编排系统重新调度或报警。
密钥轮换需要避免修改镜像。新的密钥应先注入并验证,再切换流量,最后撤销旧密钥。这样可以减少更新过程中的服务中断。
按自己的节奏,确认真正理解。