GCP Cloud Build如何识别构建镜像？images参数作用解析

首先明确你当前脚本的核心问题：你用jibBuildTar仅生成了镜像的tar归档文件，但Cloud Build的images字段不会自动扫描工作区中的tar包，这是你困惑的根源。

一、Cloud Build与"已构建镜像"的关系 #

Cloud Build不会主动扫描工作区寻找镜像文件，它对镜像的处理逻辑分两种场景：

• 直接使用Cloud Build内置Docker能力构建：当你在步骤中执行docker build这类命令时，Cloud Build会跟踪环境内置Docker守护进程中的镜像，此时images字段可正常生效。
• 通过第三方工具生成镜像文件（如Jib的tar包）：这种情况下，Cloud Build无法识别生成的tar包，必须显式添加步骤将tar包加载到Docker，或直接使用工具的推送功能跳过本地生成环节。

二、images参数的意义与作用 #

images字段是Cloud Build的镜像推送指令，具体作用如下：

• 告知Cloud Build，构建完成后将指定名称的镜像推送到GCR（或你配置的其他镜像仓库）
• 它依赖Cloud Build环境的Docker守护进程中存在对应名称的镜像，否则会触发报错
• 支持替换内置环境变量，比如你使用的$PROJECT_ID就是Cloud Build提供的内置变量

三、针对你的Jib+Gradle脚本的修正方案 #

你当前的脚本仅生成了tar包，未让Cloud Build识别到镜像，有两种可行的修正方式：

方案1：直接用Jib推送镜像（推荐，更简洁高效） #

跳过生成tar包的步骤，直接使用Jib的jib任务将镜像推送到GCR，无需依赖images字段：

steps:
- id: Test
  name: gradle:7.3-jdk17
  args: ['gradle','test']
- id: Build & Push Image
  name: gradle:7.3-jdk17
  args: ['gradle','jib', '-Dimage=gcr.io/$PROJECT_ID/my-project', '-DBRANCH_NAME=$BRANCH_NAME', '-DREVISION_ID=$REVISION_ID']

Jib会直接将构建好的镜像推送到指定的GCR仓库，无需Cloud Build额外处理。

方案2：加载tar包到Docker后用images字段推送 #

若你必须生成tar包，需添加步骤将tar包加载到Docker，让Cloud Build能识别到镜像：

steps:
- id: Test
  name: gradle:7.3-jdk17
  args: ['gradle','test']
- id: Build Docker Tar
  name: gradle:7.3-jdk17
  args: ['gradle','jibBuildTar', '-DBRANCH_NAME=$BRANCH_NAME', '-DREVISION_ID=$REVISION_ID']
- id: Load Tar to Docker
  name: docker
  args: ['load', '-i', 'build/jib-image.tar'] # Jib生成的tar包通常在build目录下，可根据实际路径调整
- id: Tag Image
  name: docker
  args: ['tag', 'your-jib-default-image-name', 'gcr.io/$PROJECT_ID/my-project'] # 替换为Jib构建时的默认镜像名，可从步骤输出中查看
images: ['gcr.io/$PROJECT_ID/my-project']

补充说明 #

• 步骤间共享的是/workspace目录，所有步骤的默认工作目录都是/workspace，你生成的文件都会保存在这里（除非手动修改工作目录）
• 使用Jib直接推送到仓库是更标准的做法，它无需依赖Docker环境，构建速度更快，也省去了tar包的处理环节

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