如何利用缓存优化Google Cloud Build？镜像缓存失效求助

一、修正现有Docker构建配置（语法与参数优化） #

你提供的第二个配置存在YAML语法错误（steps后缺少冒号、缩进不一致），先修正为正确格式，同时确保缓存逻辑生效：

steps:
- name: 'gcr.io/cloud-builders/docker'
  entrypoint: 'bash'
  args: ['-c', 'docker pull gcr.io/PROJECT_ID/node-app:latest || true']
- name: 'gcr.io/cloud-builders/docker'
  args: [
    'build',
    '--cache-from', 'gcr.io/PROJECT_ID/node-app:latest',
    '--tag', 'gcr.io/PROJECT_ID/node-app:latest',
    '.'
  ]
- name: 'gcr.io/cloud-builders/docker'
  args: ['push', 'gcr.io/PROJECT_ID/node-app:latest']
images:
- 'gcr.io/PROJECT_ID/node-app:latest'

关键注意点：

1. 确保PROJECT_ID替换为你的实际Google Cloud项目ID，且目标镜像已存在于GCR中。
2. 检查Dockerfile的层匹配性：只有当Dockerfile中未修改的层与缓存镜像的层完全一致时，才会复用缓存。如果你的Dockerfile使用了多阶段构建，需要为每个阶段指定缓存来源，例如：

   docker build \
     --cache-from gcr.io/PROJECT_ID/node-app:builder \
     --cache-from gcr.io/PROJECT_ID/node-app:latest \
     -t gcr.io/PROJECT_ID/node-app:latest .
   

   同时需要推送builder阶段的镜像到GCR，才能复用该阶段的缓存。

二、使用Cloud Build缓存卷（更高效的本地缓存） #

Cloud Build支持挂载持久化缓存卷，直接存储Docker daemon的缓存数据，无需依赖已推送的镜像，缓存复用效率更高：

steps:
- name: 'gcr.io/cloud-builders/docker'
  args: ['build', '-t', 'gcr.io/PROJECT_ID/node-app:latest', '.']
  volumes:
  - name: 'docker_cache'
    path: /var/lib/docker
- name: 'gcr.io/cloud-builders/docker'
  args: ['push', 'gcr.io/PROJECT_ID/node-app:latest']
images:
- 'gcr.io/PROJECT_ID/node-app:latest'
options:
  cache:
    volumes:
    - name: 'docker_cache'
      path: /var/lib/docker

该配置会在Cloud Build环境中创建一个持久化卷，保存Docker的构建层，后续构建直接复用本地缓存，跳过镜像拉取步骤。

三、使用Kaniko构建器（推荐，缓存可靠性更高） #

Kaniko是Google推出的无Docker daemon构建工具，专为容器化构建优化，缓存逻辑更可靠，无需手动处理镜像拉取和缓存参数：

steps:
- name: 'gcr.io/kaniko-project/executor:latest'
  args: [
    '--dockerfile=Dockerfile',
    '--destination=gcr.io/PROJECT_ID/node-app:latest',
    '--cache=true',
    '--cache-repo=gcr.io/PROJECT_ID/node-app-cache'
  ]
images:
- 'gcr.io/PROJECT_ID/node-app:latest'

说明：

• --cache=true启用缓存功能，Kaniko会自动识别可复用的构建层。
• --cache-repo指定存储缓存层的镜像仓库，Kaniko会自动管理缓存层的拉取与推送，无需额外步骤。

四、排查缓存失效的关键步骤 #

1. 查看Cloud Build日志，确认构建步骤中是否出现Using cache的日志条目：
   • 如果没有，说明缓存层不匹配，检查Dockerfile是否有修改、基础镜像是否更新。
   • 如果有但构建速度未提升，检查缓存卷或Kaniko配置是否正确。
2. 验证目标镜像确实存在于GCR中，且Cloud Build服务账号拥有该镜像的读取权限。

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