Skaffold在Github Actions中未使用缓存，重复构建镜像问题咨询

DevOps 小满

2026-7-21

解决GitHub Actions中Skaffold无法读取缓存镜像的问题

核心原因

GitHub Actions的运行环境是临时容器，每次Job执行完毕后环境会被销毁，默认情况下~/.skaffold/cache目录不会保留到下一次运行。而本地开发环境是固定的，缓存文件一直存在，所以Skaffold能正常命中缓存。

解决方案

1. 持久化Skaffold缓存目录

在GitHub Actions工作流中添加缓存步骤，将~/.skaffold/cache目录保存到GitHub的缓存服务中，下次运行时自动恢复。示例配置：

- name: 缓存Skaffold构建产物
  uses: actions/cache@v3
  with:
    path: ~/.skaffold/cache
    key: skaffold-cache-${{ hashFiles('skaffold.yaml', '**/Dockerfile') }}
    restore-keys: |
      skaffold-cache-

path指定要缓存的目录，即Skaffold的缓存路径
key用skaffold.yaml和所有Dockerfile的哈希值生成，确保配置文件不变时复用缓存，配置变更时自动触发新构建
restore-keys用于匹配最近的缓存，即使key不完全一致也能复用部分缓存内容

2. 显式启用Skaffold缓存检查

运行Skaffold命令时显式指定缓存参数（默认已开启，但显式设置更稳妥）：

skaffold build --cache-artifacts=true

3. 同步Docker镜像缓存

Skaffold的缓存依赖本地Docker镜像的存在，所以需要同时缓存Docker的镜像层。如果使用docker/build-push-action，可以添加缓存配置：

- name: Docker构建
  uses: docker/build-push-action@v4
  with:
    context: .
    push: false
    tags: your-image-tag:latest
    cache-from: type=local,src=~/.skaffold/cache/docker
    cache-to: type=local,dest=~/.skaffold/cache/docker,mode=max

这会把Docker的构建缓存存入Skaffold的缓存目录，和之前的缓存步骤联动，确保镜像层也能被复用。