无需拉取本地，如何在Google Artifact Registry中查看Docker镜像标签？

方法1：使用gcloud官方命令 #

Google Cloud CLI提供了直接查询Artifact Registry镜像元数据的命令，无需拉取镜像到本地。

• 基础命令（直接输出标签键值对）：

  gcloud artifacts docker images describe [REGION]-docker.pkg.dev/[PROJECT-ID]/[REPO-NAME]/[IMAGE-NAME]:[TAG] --format="value(image_config.labels)"
  

• 输出JSON格式的标签（方便后续处理）：

  gcloud artifacts docker images describe [REGION]-docker.pkg.dev/[PROJECT-ID]/[REPO-NAME]/[IMAGE-NAME]:[TAG] --format=json | jq '.image_config.labels'
  

注意：需要先完成gcloud认证（gcloud auth login）并设置当前项目（gcloud config set project [PROJECT-ID]）。

方法2：使用crane工具 #

crane是Google开源的容器镜像工具，专门用于远程操作镜像，轻量且无需本地拉取。

1. 安装crane：
   • macOS：brew install crane
   • Linux/Windows：通过Go安装go install github.com/google/go-containerregistry/cmd/crane@latest，或下载官方二进制包
2. 查询镜像标签的命令：

   crane config [REGION]-docker.pkg.dev/[PROJECT-ID]/[REPO-NAME]/[IMAGE-NAME]:[TAG] | jq '.Labels'
   

crane会自动复用gcloud的认证信息，无需额外配置（若已完成gcloud认证）。

方法3：直接调用Docker Registry API（进阶） #

通过Artifact Registry兼容的Docker Registry API直接查询，适合自动化脚本场景：

1. 获取认证token：

   TOKEN=$(gcloud auth print-access-token)
   

2. 调用API获取镜像配置并提取标签：

   curl -H "Authorization: Bearer $TOKEN" https://[REGION]-docker.pkg.dev/v2/[PROJECT-ID]/[REPO-NAME]/[IMAGE-NAME]/manifests/[TAG] | jq '.config.digest' | tr -d '"' | xargs -I {} curl -H "Authorization: Bearer $TOKEN" https://[REGION]-docker.pkg.dev/v2/[PROJECT-ID]/[REPO-NAME]/[IMAGE-NAME]/blobs/{} | jq '.Labels'
   

此方法需要手动处理镜像配置的digest跳转，步骤较多，适合熟悉API的用户。

内容的提问来源于stack exchange，提问作者Thanh Long Phan