容器与云原生 / 系统课时

利用构建缓存

利用构建缓存

本课解决 Docker 镜像重复构建耗时的问题,通过理解缓存失效规则调整 Dockerfile 顺序,让依赖安装、源码编译等稳定步骤复用已有结果,减少开发迭代和生产发布等待时间。

学习目标

  • 理解 Docker 构建缓存的匹配条件和失效范围
  • 掌握按变更频率组织 Dockerfile 指令的方法
  • 能够验证缓存命中效果并定位缓存未生效原因

构建缓存的工作机制

Docker 构建镜像时会为每一条 Dockerfile 指令生成缓存层。下一次构建时,Docker 会比较当前指令及相关上下文是否与历史层一致,如果匹配则直接复用结果,而不是重新执行操作。

缓存并不是简单根据命令文本判断。COPY 会受到复制文件内容变化影响,RUN 会受到前置层变化影响。一旦某一层失效,后续层通常也会重新执行。

Docker 构建缓存层命中关系图

调整 Dockerfile 指令顺序

优化缓存的核心原则是:变化频率低的内容放前面,变化频率高的内容放后面。依赖文件通常比业务源码稳定,因此应该先复制依赖描述文件并安装依赖,再复制源码。

例如 Node.js 项目中,不推荐先复制全部源码再安装依赖,因为任何源码变化都会导致依赖安装层失效。

dockerfile
FROM node:22-alpine

WORKDIR /app

# 先复制依赖清单,保证依赖层可以复用
COPY package*.json ./
RUN npm ci

# 源码变化不会影响前面的依赖缓存
COPY . .
RUN npm run build

CMD ["node", "dist/server.js"]

预期结果

text
首次构建:执行 npm ci 和 npm run build
再次构建且 package.json 未变化:复用 npm ci 缓存,仅重新执行源码相关步骤

这种结构适合大多数应用项目,也便于在 CI 环境中减少重复依赖下载。

查看缓存命中情况

构建时可以通过输出信息判断哪些步骤被复用。开启详细输出可以帮助分析具体失效位置。

bash
docker build --progress=plain -t demo-app:<ID> .

预期输出

text
#<ID> CACHED [2/6] COPY package*.json ./
#<ID> CACHED [3/6] RUN npm ci
#<ID> RUN npm run build

如果看到大量步骤重新执行,需要检查是否修改了频繁变化的文件、构建上下文是否过大,或者是否使用了会破坏缓存的参数。

常见缓存失效原因

以下情况会让缓存无法复用:

  • 修改了参与 COPY 的文件内容
  • 调整了 Dockerfile 中指令顺序
  • 使用了不可复现的构建步骤,例如依赖源内容变化
  • 使用 --no-cache 强制关闭缓存

实际生产构建中,应结合 .dockerignore 排除无关文件,避免日志、临时文件等变化影响缓存。

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

目录与阅读设置

阅读设置

17

记录一个想法

利用构建缓存

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

登录哪都通