x86_64环境docker buildx构建arm64镜像无法命中缓存问题咨询

你当前创建的buildx实例默认使用docker-container驱动，所有构建中间层缓存都存在临时启动的构建容器内部，构建结束容器销毁后缓存就会丢失；加上你之前执行的build命令没有配置任何缓存导入导出规则，自然每次构建都要从头跑所有步骤。

方案1：本地目录持久化缓存（无额外依赖，命中率最高） #

构建时通过--cache-to、--cache-from参数指定将缓存持久化存储到宿主机本地目录，后续构建直接从该目录读取缓存即可。
直接替换原有构建命令为如下内容即可：

docker buildx build . \
  --platform linux/arm64 \
  -t test-image:p-arm64 \
  -f ./arm64.Dockerfile \
  --cache-to type=local,dest=./.buildx-cache/arm64,mode=max \
  --cache-from type=local,src=./.buildx-cache/arm64 \
  --load

参数说明：

• dest指定缓存存储的本地路径，可自行修改，建议加入.gitignore避免提交到代码仓库
• mode=max表示缓存所有构建中间层，能实现最高的缓存命中率
• 首次执行该命令时仍会全量构建（本地无缓存文件），从第二次构建开始，只要对应层的Dockerfile指令、关联文件没有变动，就会直接复用缓存，20-30分钟的构建流程基本几十秒就能跑完。

方案2：使用已有镜像作为缓存源 #

如果每次构建完成后都会将镜像留存本地或推送到私有镜像仓库，可以直接将历史构建的镜像作为缓存源，不需要单独维护缓存目录，示例命令如下：

# 推送到镜像仓库场景
docker buildx build . \
  --platform linux/arm64 \
  -t test-image:p-arm64 \
  -f ./arm64.Dockerfile \
  --cache-from type=registry,ref=test-image:p-arm64 \
  --push

• 调整Dockerfile层顺序：将变动频率极低的步骤（比如安装系统依赖、安装固定版本的Python包）放在Dockerfile靠前位置，将频繁变动的步骤（比如拷贝业务代码、编译业务程序）放在最后，避免上层变动导致下层所有缓存失效。你当前提供的Dockerfile层顺序逻辑合理，后续新增步骤时注意该规则即可。
• 多架构构建场景下，为不同架构指定独立的缓存目录，避免不同架构的缓存互相覆盖导致命中率下降。
• 非必要不要添加--no-cache参数，Dockerfile里也尽量不要写无固定版本的依赖安装、拉取浮动标签镜像这类每次执行结果都可能变的命令，不然会直接导致缓存失效。

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