Docker多阶段构建：如何推送所有阶段镜像层至缓存

你可以通过以下两种简洁的方式，把base、test、prod所有阶段的层都存入同一个缓存镜像，无需为每个目标单独维护缓存：

方法一：添加缓存聚合阶段（推荐用于CI/CD流水线） #

在Dockerfile末尾新增一个依赖所有阶段的空阶段，构建这个阶段时会触发所有前置阶段的构建，从而把所有层的缓存导出到同一个镜像中。

步骤1：修改Dockerfile #

在现有内容最后添加以下阶段：

# 新增缓存聚合阶段，仅用于触发所有前置阶段的构建
FROM scratch as cache-collector
# 复制空内容触发依赖，不会产生额外镜像层
COPY --from=base / /dev/null
COPY --from=test / /dev/null
COPY --from=prod / /dev/null

步骤2：构建聚合阶段并导出完整缓存 #

执行这条命令，Docker会构建base、test、prod所有阶段，并将所有层的缓存推送到指定的registry镜像：

docker build --target cache-collector --cache-to type=registry,ref=<registry>/<cache-image>,mode=max .

步骤3：复用缓存构建目标阶段 #

后续构建prod或test时，直接从这个完整缓存镜像拉取缓存：

# 构建生产镜像
docker build --target prod --cache-from type=registry,ref=<registry>/<cache-image> -t myapp .

# 构建测试镜像
docker build --target test --cache-from type=registry,ref=<registry>/<cache-image> -t myapp-test .

方法二：多次构建复用同一个缓存镜像（无需修改Dockerfile） #

如果不想改动Dockerfile，可以通过两次构建分别生成test和prod的缓存，每次构建都复用并更新同一个缓存镜像：

# 先构建test阶段，更新缓存镜像
docker build --target test \
  --cache-to type=registry,ref=<registry>/<cache-image>,mode=max \
  --cache-from type=registry,ref=<registry>/<cache-image> \
  -t myapp-test .

# 再构建prod阶段，继续更新缓存镜像
docker build --target prod \
  --cache-to type=registry,ref=<registry>/<cache-image>,mode=max \
  --cache-from type=registry,ref=<registry>/<cache-image> \
  -t myapp .

两次构建完成后，缓存镜像就包含了base、test、prod的所有层，后续构建任意目标都能直接复用缓存。

两种方法的对比 #

• 聚合阶段方法：只需一次构建即可生成完整缓存，适合流水线中一次性预生成缓存，后续构建效率更高，但需要修改Dockerfile。
• 多次构建方法：无需改动Dockerfile，操作灵活，但需要执行两次构建命令，适合临时场景或现有流水线的快速适配。

内容的提问来源于stack exchange，提问作者MyUsername112358