容器与云原生 / 系统课时
配置文件应该打进镜像还是挂载
配置文件应该打进镜像还是挂载
同一个应用在开发、测试和生产环境往往需要不同配置。关键不是简单判断“打进镜像还是挂载更好”,而是决定配置是否应该跟随镜像版本固定,以及运行时变更是否必须被外部系统追踪。
学习目标
- 理解构建时内置配置与运行时挂载配置的维护差异
- 会用 Dockerfile 内置配置,也会用只读 Bind Mount 覆盖配置
- 能避免在运行中的容器里手工修改配置造成不可追踪状态
两种方式的差别
| 方式 | 主要优点 | 主要代价 | 更适合 |
|---|---|---|---|
| 打进镜像 | 镜像版本同时固定应用与配置,容易复现和回滚 | 改配置通常需要重新构建并发布镜像 | 稳定、版本化、需严格追踪的配置 |
| 运行时挂载 | 同一镜像可配不同环境,改文件即可准备下一次部署 | 依赖宿主机或编排平台提供正确文件 | 环境差异明显、配置需独立发布的场景 |
选择时可以问一个问题:这份配置变化时,是否希望镜像摘要也随之变化? 如果答案是“希望”,内置配置更容易形成不可变发布物;如果答案是“不希望”,挂载更灵活,但外部配置本身必须有版本和审计。
把配置打进镜像
下面用 Nginx 演示一份完整的站点配置。default.conf 内容如下:
server {
listen 80;
server_name _;
location / {
default_type text/plain;
return 200 "config=v1\n";
}
}Dockerfile 把该配置复制到镜像中:
FROM nginx:1.27-alpine
COPY default.conf /etc/nginx/conf.d/default.conf构建镜像、启动容器并访问验证:
docker build -q -t config-demo:v1 . >/dev/null
docker run --rm -d --name config-demo-baked -p 8080:80 config-demo:v1 >/dev/null
curl -fsS http://127.0.0.1:8080/
docker rm -f config-demo-baked >/dev/null预期输出:
config=v1这种方式中,配置成为镜像的一部分。要修改配置,应更新文件、重新构建并发布新镜像,而不是进入已运行容器手改。
在运行时挂载配置
如果配置要独立于镜像发布,可以继续使用官方 Nginx 镜像,并把宿主机文件只读挂载到容器。先把 default.conf 中的返回内容改为 config=v2,再执行:
docker run --rm -d --name config-demo-mounted -p 8081:80 -v "$PWD/default.conf:/etc/nginx/conf.d/default.conf:ro" nginx:1.27-alpine >/dev/null
curl -fsS http://127.0.0.1:8081/
docker rm -f config-demo-mounted >/dev/null预期输出:
config=v2ro 表示容器只能读取挂载文件,能避免应用意外写回宿主机配置。若 8080 或 8081 已被占用,应先换用未占用的宿主端口再验证。
生产环境怎么选
稳定且与应用版本紧密绑定的配置,适合打进镜像。例如 Nginx 路由规则、应用默认配置或与代码强耦合的模板。这样每个镜像标签都对应一套明确内容,回滚镜像时配置也随之回滚。
需要按环境注入、但不希望为每个环境重复构建镜像的配置,更适合运行时挂载,例如环境专属的反向代理目标、证书路径映射或外部系统地址。此时应把配置文件放在受控仓库、配置中心或编排平台中,并通过发布记录追踪版本。
秘密值不应仅因为“也是配置”就直接写入普通文件或镜像层。密码、令牌和私钥应使用专门的 Secret 管理能力,并限制暴露范围。
不要在容器里手工改配置
直接 docker exec 进入容器再用编辑器改文件,会产生只存在于当前容器可写层的状态。容器一旦删除或重建,这些修改通常就消失;多副本场景还可能出现每个实例配置不同的问题。
更可靠的原则是:镜像内配置通过重新构建变更,镜像外配置通过受控的外部配置源变更。 无论采用哪一种,都应让下一次重建能够仅凭镜像与部署声明恢复出同样的运行状态。