容器与云原生 / 系统课时

配置流水线构建缓存

配置流水线构建缓存

本课解决 CI/CD 中 Docker 镜像重复构建耗时过长的问题,通过 BuildKit 缓存机制复用稳定层,同时控制不同分支之间的缓存边界,最终让流水线在保证安全的前提下提升构建效率。

学习目标

  • 理解 BuildKit 本地缓存和远程缓存的工作方式
  • 掌握在 CI 流水线中导入与导出镜像构建缓存
  • 了解缓存污染、失效和分支隔离的处理方法

BuildKit 缓存解决什么问题

Docker 构建会根据 Dockerfile 指令和上下文计算缓存命中。当依赖安装、源码复制等步骤频繁变化时,没有缓存的流水线会重复执行耗时操作。BuildKit 提供更灵活的缓存导入导出能力,可以把缓存保存在本机目录、镜像仓库或 CI 缓存服务中。

缓存并不是镜像本身,而是构建过程中可复用的中间结果。正确设计缓存策略可以减少网络下载和编译时间。

配置本地与远程缓存

在 CI 环境中,常见做法是使用 docker buildx build,通过 --cache-from 读取已有缓存,通过 --cache-to 保存新的缓存。

bash
docker buildx build \
  --tag registry.example.com/app:<ID> \
  --cache-from type=local,src=/tmp/build-cache \
  --cache-to type=local,dest=/tmp/build-cache-new,mode=max \
  --load \
  .

预期输出

text
#1 importing cache manifest
#2 exporting cache
#3 naming to registry.example.com/app:<ID>

本地缓存适合单机 Runner 或持久化工作节点。共享 Runner 通常需要远程缓存,例如将缓存导出到镜像仓库。

bash
docker buildx build \
  --tag registry.example.com/app:<ID> \
  --cache-from type=registry,ref=registry.example.com/cache:main \
  --cache-to type=registry,ref=registry.example.com/cache:main,mode=max \
  --push \
  .

预期输出

text
importing cache manifest from registry.example.com/cache:main
exporting cache to registry.example.com/cache:main
pushing image

处理分支隔离与缓存风险

多人协作时不应让所有分支共享同一个缓存。开发分支可能包含未验证依赖或特殊构建结果,如果直接污染主分支缓存,会导致发布构建出现不可预测行为。常见策略包括:

  • 主分支使用稳定缓存标签,例如 cache:main
  • 功能分支使用独立缓存标签,例如 cache:feature-<ID>
  • 发布流水线只读取可信来源缓存

缓存命中失败时,应优先确认 Dockerfile 层变化、构建参数变化和缓存来源是否正确,而不是直接关闭缓存。

验证缓存是否生效

可以通过 BuildKit 输出观察命中情况,也可以在流水线中记录构建时间变化。缓存有效时,稳定步骤会显示 CACHED,变化步骤才重新执行。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置流水线构建缓存

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

登录哪都通