容器与云原生 / 系统课时
什么时候应该重新构建镜像
什么时候应该重新构建镜像
Compose 配置一改就重建镜像,既慢又容易把“运行时配置”和“镜像内容”混在一起。判断是否需要 rebuild 的关键不是“文件有没有改”,而是这次改动是否会改变 Dockerfile 的构建输入或最终镜像文件系统。
学习目标
- 区分镜像构建时内容与容器运行时参数
- 根据改动类型判断是否需要
docker compose build - 正确选择
up --no-build、build与up --build
先判断改动属于构建时还是运行时
镜像应保存应用二进制、依赖、静态资源和基础运行环境;环境变量、端口映射、重启策略、网络连接等通常由容器启动配置决定。两类改动的处理方式不同。
| 改动 | 通常要重建镜像吗 | 原因 |
|---|---|---|
应用源码被 COPY 进镜像 |
要 | 镜像文件系统内容变化 |
| 编译产物、依赖锁文件变化 | 要 | 构建结果或依赖层变化 |
| Dockerfile 指令变化 | 要 | 镜像构建过程变化 |
build.args 参与 Dockerfile 构建 |
要 | 构建输入变化 |
environment 或 env_file 改变 |
不要 | 运行时注入配置 |
| 端口、网络、重启策略变化 | 不要 | 属于容器配置 |
| bind mount 中的源码变化 | 通常不要 | 容器直接读取宿主机文件 |
“通常”很重要:如果应用把某个环境值在编译阶段写进静态文件,那它就是构建输入;如果只是容器启动时读取环境变量,就不需要重建。
运行参数变化时只重建容器配置
下面的 Compose 配置同时声明构建方式和运行时环境变量;假设镜像此前已经构建成功:
services:
app:
build: .
image: compose-demo:latest
environment:
APP_MODE: ${APP_MODE:-prod}只把运行模式从 prod 改为 debug 时,可以明确禁止构建,并检查 Compose 解析后的值:
APP_MODE=debug docker compose up -d --no-build app >/dev/null 2>&1
APP_MODE=debug docker compose config | grep 'APP_MODE:' | sed 's/^[[:space:]]*//'预期输出
APP_MODE: debug这类变化需要 Compose 按新配置创建或更新容器,但没有必要重新执行 Dockerfile。若镜像尚不存在,--no-build 会让启动失败,这正说明它只适用于“已有可用镜像、仅改运行参数”的场景。
镜像内容变化时必须产生新镜像
如果修改的是会进入镜像的源码、依赖文件或 Dockerfile,就应该产生新镜像。可以把“构建”和“启动”拆开,也可以让 up --build 在启动前执行构建。
下面演示拆开的方式;只有前一条构建成功,才继续启动:
docker compose build app >/dev/null 2>&1
docker compose up -d --no-build app >/dev/null 2>&1
echo "built-then-started"预期输出
built-then-started第二条命令故意使用 --no-build,因为第一条已经完成镜像构建。如果跳过第一条,只执行 docker compose up -d --no-build app,Compose 会继续使用现有镜像;宿主机源码即使已经修改,也不会自动进入旧镜像。
用一个问题决定是否 rebuild
判断时只问:这次改动会不会改变最终镜像的内容或构建过程?
会改变,就重建,例如应用二进制、前端打包产物、依赖、系统包、Dockerfile 或参与构建的参数发生变化。不会改变,就不要重建,例如环境变量、端口映射、网络、资源限制、重启策略和大多数 bind mount 内容。
开发环境为了省事可以用 docker compose up --build 让 Compose 在启动前执行构建;生产发布更适合把“构建镜像”和“部署镜像”分开,并使用明确的镜像标签或摘要。这样能够准确知道当前运行的是哪次构建,也更容易回滚。