无需拉取镜像，如何从GCR获取容器镜像标签？

你可以通过两种方式在不拉取镜像的前提下获取GCR中容器镜像的标签元数据：

一、使用gcloud CLI（推荐） #

gcloud container images list-tags命令可以直接列出指定镜像仓库下所有镜像的标签、摘要、创建时间等元数据，完全不需要拉取镜像。

命令示例： #

gcloud container images list-tags gcr.io/[PROJECT-ID]/[IMAGE]

典型输出： #

DIGEST        TAGS         TIMESTAMP
sha256:xxxx   latest,v1.0  2024-05-20T12:34:56
sha256:yyyy   v0.9         2024-05-19T09:87:65

如果需要获取镜像构建时添加的自定义标签详情，加上--format=json参数即可，输出的JSON会包含labels字段：

gcloud container images list-tags gcr.io/[PROJECT-ID]/[IMAGE] --format=json

二、使用Docker Distribution API（REST方式） #

如果需要通过API实现自动化处理，可以调用GCR兼容的Docker Distribution API，步骤如下：

1. 获取访问令牌 #

先通过gcloud生成有效访问令牌：

export GCR_TOKEN=$(gcloud auth print-access-token)

2. 获取镜像清单（Manifest） #

调用API获取指定标签的镜像清单，从中提取配置文件的摘要：

curl -H "Authorization: Bearer $GCR_TOKEN" https://gcr.io/v2/[PROJECT-ID]/[IMAGE]/manifests/latest

在返回的JSON中，找到config.digest字段（格式类似sha256:abc123...）。

3. 获取镜像配置Blob #

用步骤2得到的配置摘要，调用API获取镜像配置文件，其中的Labels字段就是你需要的自定义标签元数据：

curl -H "Authorization: Bearer $GCR_TOKEN" https://gcr.io/v2/[PROJECT-ID]/[IMAGE]/blobs/sha256:abc123...

返回的JSON结构示例：

{
  "config": {
    "Labels": {
      "CI_BUILD_ID": "12345",
      "APP_VERSION": "v1.0.0"
    }
  }
}

批量处理建议 #

针对你需要处理250+镜像的场景，可通过脚本实现自动化：

• 先用gcloud container images list --repository=gcr.io/[PROJECT-ID]列出当前项目下的所有镜像仓库
• 循环遍历每个仓库，调用list-tags命令或API获取标签元数据
• 将结果整理到目标数据集

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