Google Cloud Build+Kaniko构建不缓存及镜像未正常推送问题解决

一、镜像未出现在容器注册表的修复 #

你的--destination参数可能存在格式问题，或是Kaniko执行时出现未捕获错误。请确认：

• gcr.io/project中的project是你的Google Cloud项目ID（而非项目名称）
• 镜像名称可简化为gcr.io/[PROJECT_ID]/repo_name:$COMMIT_SHA，若需区分仓库可保留github.com/user/前缀，但需保证路径合法

二、Kaniko缓存不生效的核心修复 #

Cloud Build每次构建都是全新临时环境，Kaniko无法使用本地缓存，必须指定远程缓存仓库将缓存层存储到GCR中。修改cloudbuild.yaml如下：

steps:
- name: 'gcr.io/kaniko-project/executor:latest'
  args:
  - --destination=gcr.io/[PROJECT_ID]/repo_name:$COMMIT_SHA
  - --cache=true
  - --cache-ttl=6h
  - --cache-repo=gcr.io/[PROJECT_ID]/repo_name-cache  # 指定远程缓存仓库
  - --dockerfile=Dockerfile
timeout: 7200s

关键配置说明 #

• --cache-repo：必须指定GCR内的仓库路径，用于存储构建缓存层，该仓库无需提前创建，Kaniko会自动生成缓存镜像
• 确保Cloud Build服务账号拥有GCR读写权限（默认服务账号已具备，若使用自定义账号，需检查Storage Object Admin或Container Registry Service Agent权限）

三、额外优化建议 #

• 固定Kaniko版本：避免使用latest，改用具体版本（如gcr.io/kaniko-project/executor:v1.20.0），防止版本更新引发兼容性问题
• 优化Dockerfile指令顺序：将不变的指令（如依赖安装）放在前面，变动内容（如代码复制）放在后面，提升缓存命中率
• 排查构建日志：若缓存仍不生效，查看Cloud Build详细日志，搜索cache关键字，确认Kaniko是否尝试拉取缓存层

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