容器与云原生 / 系统课时

利用构建缓存

利用构建缓存

重复执行 docker build 时,真正耗时的往往不是复制少量业务代码,而是下载依赖、编译或安装系统包。Docker 构建缓存能复用未变化的步骤;通过把稳定输入放在前面、频繁变化的文件放在后面,可以显著减少后续构建需要重新执行的层。

学习目标

  • 理解 Dockerfile 指令变化为何会让后续缓存连续失效
  • 通过调整 COPY 与依赖安装顺序提高缓存命中率
  • 用 BuildKit 输出判断某一步是重新执行还是直接命中缓存

缓存为什么会连续失效

Dockerfile 会按顺序执行。某一步的指令或它依赖的输入发生变化时,该步骤需要重新计算,后续依赖它的步骤也无法继续使用原来的缓存。因此,最容易变化的业务源码如果过早被 COPY 进镜像,会把本来稳定的依赖安装层也一起拖入重建。

Docker 构建缓存失效链

对 Node.js 项目,一个高命中率的关键是先复制依赖清单并执行 npm ci,最后再复制源码。这样日常修改 src 时,依赖清单没有变化,昂贵的依赖安装层仍可复用。

dockerfile
# syntax=docker/dockerfile:1
FROM node:22-alpine
WORKDIR /app

# 依赖清单变化频率低,单独形成稳定缓存边界
COPY package.json package-lock.json ./
RUN npm ci

# 业务源码频繁变化,放在依赖安装之后
COPY src ./src
CMD ["node", "src/index.js"]

这是完整 Dockerfile。要让构建上下文保持稳定,还应避免把 node_modules、Git 历史和本地临时文件发送给构建器。

text
node_modules
.git
npm-debug.log

上面是 .dockerignore 的完整示例。它不会产生控制台输出;验证方法是在构建时观察发送的 context 大小,并确认这些目录没有参与 COPY。

观察第一次构建

在包含 Dockerfile、package.json、package-lock.json 与 src/index.js 的项目目录执行 BuildKit 构建。--progress=plain 会显示每一步是否执行或命中缓存。

bash
DOCKER_BUILDKIT=1 docker build --progress=plain -t cache-demo .

预期输出(步骤编号和耗时会不同)

text
#<ID> [<STAGE> 3/5] COPY package.json package-lock.json ./
#<ID> DONE <TIME>
#<ID> [<STAGE> 4/5] RUN npm ci
#<ID> DONE <TIME>
#<ID> [<STAGE> 5/5] COPY src ./src
#<ID> DONE <TIME>

第一次构建没有可复用记录,因此依赖安装需要真实执行。这里的 <ID>、<STAGE> 和 <TIME> 都是动态值。

验证源码变化仍复用依赖层

只修改源码而不改依赖清单,例如更新 src/index.js,然后再次执行同一条构建命令。

bash
touch src/index.js
DOCKER_BUILDKIT=1 docker build --progress=plain -t cache-demo .

预期输出(只展示与缓存判断相关的步骤)

text
#<ID> [<STAGE> 3/5] COPY package.json package-lock.json ./
#<ID> CACHED
#<ID> [<STAGE> 4/5] RUN npm ci
#<ID> CACHED
#<ID> [<STAGE> 5/5] COPY src ./src
#<ID> DONE <TIME>

关键观察点是 RUN npm ci 仍显示 CACHED。如果把 COPY . . 放到 RUN npm ci 之前,那么任何源码变化都会改变前置层输入,依赖安装也会重新执行。

什么时候应该主动失效缓存

缓存不是越多越好。当 package-lock.json 变化时,重新执行 npm ci 是正确行为,因为依赖集合已经改变;基础镜像、构建参数或被复制文件发生变化,也可能让相关层重新计算。遇到怀疑缓存隐藏问题的情况,可以显式禁用缓存做一次对照构建。

bash
DOCKER_BUILDKIT=1 docker build --no-cache --progress=plain -t cache-demo:no-cache .

预期输出

text
#<ID> [<STAGE> 3/5] COPY package.json package-lock.json ./
#<ID> DONE <TIME>
#<ID> [<STAGE> 4/5] RUN npm ci
#<ID> DONE <TIME>

--no-cache 适合验证缓存是否影响结果,不适合成为日常默认选项。真正有效的优化是让 Dockerfile 的顺序反映文件变化频率:稳定且昂贵的步骤尽量靠前,频繁变化的源码尽量靠后,同时用 .dockerignore 减少无关构建上下文。

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

目录与阅读设置

阅读设置

17

记录一个想法

利用构建缓存

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

登录哪都通