GitHub Action中gha Docker缓存远慢于镜像重构的问题问询

问题背景 #

配置GitHub Action构建并测试Docker镜像，构建过程中需下载6GB的Huggingface模型（可优化至2GB，因存在重复下载三次权重的情况）。原本想通过GHA缓存提速，但缓存生效后构建速度反而大幅变慢。

无缓存的GitHub Action配置 #

- name: Build Image
        shell: bash
        run: |
          docker buildx build -t ${IMAGE_TAG} -f ./Dockerfile .

耗时：3分23秒

带缓存的GitHub Action配置 #

- name: Build Image
        uses: docker/build-push-action@v5
        with:
          push: false  # do not push to remote registry
          load: true  # keep in local Docker registry
          context: .
          file: ./Dockerfile
          tags: ${{env.IMAGE_TAG}}
          cache-from: type=gha
          cache-to: type=gha,mode=max

耗时：7分58秒（首次配置提交时的初始构建耗时12分53秒）

关键细节：从Huggingface下载6GB模型约耗时30秒，而从GitHub下载4GB缓存镜像耗时279秒。该问题并非个例，Docker官方仓库已有相关议题讨论。

解决方法 #

• 优先优化模型下载逻辑，缩小缓存体积
  修改Dockerfile中的模型下载步骤，避免重复下载三次权重，把6GB的下载量压缩到2GB。比如指定只拉取必要的权重文件，而非完整重复的内容。这不仅能降低基础构建时间，还能减小缓存镜像的体积，从根源上减少缓存下载的耗时。

• 调整GHA缓存策略
  当前配置使用mode=max会缓存所有镜像层，包括很多不必要的内容。可以改为mode=min，仅缓存构建阶段的关键中间层；或者明确指定需要缓存的特定阶段，避免缓存冗余层。

• 替换缓存存储源
  改用Docker Hub或私有镜像仓库作为缓存源，这类存储的下载速度通常优于GitHub缓存。或者单独用GitHub Artifact存储模型文件：在Action步骤中先下载模型并上传到Artifact，构建Docker时直接从Artifact读取模型，跳过重复下载，也不用缓存大体积的镜像层。

• 优化Dockerfile分层顺序
  将模型下载步骤放在Dockerfile的靠后位置，确保依赖安装等高频变更的步骤在前。这样前面的层变更时，模型层的缓存仍能复用，减少无效的缓存更新与下载。

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