容器与云原生 / 系统课时

配置文件应该打进镜像还是挂载

配置文件应该打进镜像还是挂载

同一个应用在开发、测试和生产环境往往需要不同配置。关键不是简单判断“打进镜像还是挂载更好”,而是决定配置是否应该跟随镜像版本固定,以及运行时变更是否必须被外部系统追踪。

学习目标

  • 理解构建时内置配置与运行时挂载配置的维护差异
  • 会用 Dockerfile 内置配置,也会用只读 Bind Mount 覆盖配置
  • 能避免在运行中的容器里手工修改配置造成不可追踪状态

两种方式的差别

方式 主要优点 主要代价 更适合
打进镜像 镜像版本同时固定应用与配置,容易复现和回滚 改配置通常需要重新构建并发布镜像 稳定、版本化、需严格追踪的配置
运行时挂载 同一镜像可配不同环境,改文件即可准备下一次部署 依赖宿主机或编排平台提供正确文件 环境差异明显、配置需独立发布的场景

选择时可以问一个问题:这份配置变化时,是否希望镜像摘要也随之变化? 如果答案是“希望”,内置配置更容易形成不可变发布物;如果答案是“不希望”,挂载更灵活,但外部配置本身必须有版本和审计。

把配置打进镜像

下面用 Nginx 演示一份完整的站点配置。default.conf 内容如下:

nginx
server {
    listen 80;
    server_name _;
    location / {
        default_type text/plain;
        return 200 "config=v1\n";
    }
}

Dockerfile 把该配置复制到镜像中:

dockerfile
FROM nginx:1.27-alpine
COPY default.conf /etc/nginx/conf.d/default.conf

构建镜像、启动容器并访问验证:

bash
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

预期输出:

text
config=v1

这种方式中,配置成为镜像的一部分。要修改配置,应更新文件、重新构建并发布新镜像,而不是进入已运行容器手改。

在运行时挂载配置

如果配置要独立于镜像发布,可以继续使用官方 Nginx 镜像,并把宿主机文件只读挂载到容器。先把 default.conf 中的返回内容改为 config=v2,再执行:

bash
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

预期输出:

text
config=v2

ro 表示容器只能读取挂载文件,能避免应用意外写回宿主机配置。若 8080 或 8081 已被占用,应先换用未占用的宿主端口再验证。

生产环境怎么选

稳定且与应用版本紧密绑定的配置,适合打进镜像。例如 Nginx 路由规则、应用默认配置或与代码强耦合的模板。这样每个镜像标签都对应一套明确内容,回滚镜像时配置也随之回滚。

需要按环境注入、但不希望为每个环境重复构建镜像的配置,更适合运行时挂载,例如环境专属的反向代理目标、证书路径映射或外部系统地址。此时应把配置文件放在受控仓库、配置中心或编排平台中,并通过发布记录追踪版本。

秘密值不应仅因为“也是配置”就直接写入普通文件或镜像层。密码、令牌和私钥应使用专门的 Secret 管理能力,并限制暴露范围。

不要在容器里手工改配置

直接 docker exec 进入容器再用编辑器改文件,会产生只存在于当前容器可写层的状态。容器一旦删除或重建,这些修改通常就消失;多副本场景还可能出现每个实例配置不同的问题。

更可靠的原则是:镜像内配置通过重新构建变更,镜像外配置通过受控的外部配置源变更。 无论采用哪一种,都应让下一次重建能够仅凭镜像与部署声明恢复出同样的运行状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置文件应该打进镜像还是挂载

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

登录哪都通