CI/CD / 系统课时

优化镜像构建层

优化镜像构建层

这一课通过调整 Dockerfile 的分层顺序、稳定依赖层并缩小构建上下文,让源码频繁变化时尽量复用已有缓存。完成后,同一项目的二次构建只重跑真正受影响的层,而不是每次都重新安装依赖。

学习目标

  • 能判断 Dockerfile 中哪些指令会使后续缓存失效。
  • 能通过“先稳定、后易变”的分层顺序提高缓存命中率。
  • 能用 .dockerignore 减少无关文件进入构建上下文。

先理解缓存失效链

Docker 构建会按指令顺序生成层。某一层的输入发生变化后,该层以及后续依赖层通常都需要重新执行。因此,把变化频率高的源码复制放在依赖安装之前,会让一次普通代码修改也触发完整依赖安装。

更有效的顺序是:先复制较稳定的依赖清单,安装依赖,再复制频繁变化的业务代码。这样只修改源码时,依赖层仍可命中缓存。

Docker 构建缓存失效与复用关系

调整 Dockerfile 的分层顺序

优化后的核心写法如下。依赖清单变化频率通常低于业务源码,因此把它们放在单独的 COPY 层中。

dockerfile
FROM node:22-alpine

WORKDIR /app

COPY package.json package-lock.json ./
RUN npm ci --omit=dev && npm cache clean --force

COPY --chown=node:node . .

USER node
CMD ["npm", "start"]

如果把 COPY . . 放到 RUN npm ci 之前,那么任意源码文件变化都会让依赖安装层重新执行。只有依赖清单变化时才重新安装依赖,通常能显著缩短日常 CI 构建时间。

缩小构建上下文

构建上下文中的无关文件既增加上传和哈希计算,也可能意外进入镜像。项目根目录可以加入 .dockerignore:

text
.git
node_modules
npm-debug.log
coverage
dist
.env
.env.*

这里忽略的是不应参与镜像构建的本地文件。若你的部署确实需要 dist 或某个环境文件,就不能照抄忽略项,必须按实际构建流程调整。

用二次构建验证缓存

第一次构建完成后,只修改一个不影响 package.json 和 package-lock.json 的源码文件,再执行同一命令:

bash
docker build --progress=plain -t demo-app:cache .

预期输出的关键片段

text
#<ID> [<ID>/<ID>] RUN npm ci --omit=dev && npm cache clean --force
#<ID> CACHED
...
#<ID> [<ID>/<ID>] COPY --chown=node:node . .
#<ID> DONE <TIME>

BuildKit 的步骤编号和耗时会因 Docker 版本与机器状态而不同,所以 <ID>、<TIME> 都是动态占位。验证重点不是固定日志文本,而是确认依赖安装层显示 CACHED,而源码复制层重新执行。

判断是否真的值得继续拆层

层数越多并不等于构建越快。只有当某一组输入稳定、执行成本高且值得缓存时,单独成层才有价值。依赖安装、系统包安装通常值得稳定缓存;频繁变化的源码则应尽量靠后。

如果依赖层仍频繁失效,优先检查依赖清单是否被无关脚本改写、构建参数是否变化、基础镜像标签是否漂移,以及 .dockerignore 是否遗漏高频变化的大文件。优化目标是减少无效重建,而不是追求最多的层。

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

目录与阅读设置

阅读设置

17

记录一个想法

优化镜像构建层

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

登录哪都通