是否有Python SDK可用于编程检测Google Container Registry（GCR）中指定Docker镜像是否存在

当然可以不用依赖gcloud CLI来完成这个需求，Google官方提供了google-cloud-containerregistry这个Python库，专门用来以编程方式操作Container Registry（包括GCR）。下面是具体的实现步骤和代码示例：

1. 安装依赖库 #

首先需要安装官方的SDK包，在终端执行：

pip install google-cloud-containerregistry

2. 配置认证 #

访问GCR需要对应的权限，你可以通过以下两种方式完成认证：

• 本地开发/非GCP环境：下载服务账号JSON密钥文件，设置环境变量指向该文件：

  export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
  

  服务账号需要拥有storage.objects.get权限（可以通过给账号分配Storage Object Viewer角色来实现）。
• GCP内部环境（比如Cloud Functions、GCE虚拟机等）：应用会自动获取默认凭据，无需额外配置。

3. 代码实现示例 #

下面是一个完整的函数，用来检查指定的GCR镜像是否存在：

from containerregistry.client import docker_name
from containerregistry.client.v2_2 import docker_image
from containerregistry.client.v2_2 import exceptions as v2_exceptions

def check_gcr_image_exists(image_name: str) -> bool:
    """检查GCR中的Docker镜像是否存在"""
    try:
        # 解析镜像名称，支持带标签或不带标签（不带标签默认用latest）
        repo_name = docker_name.Repository(image_name)
        # 尝试获取镜像的manifest文件，如果成功则表示镜像存在
        with docker_image.FromRegistry(repo_name) as img:
            # 获取manifest会触发对GCR的请求，若镜像不存在会抛出404异常
            img.manifest()
        return True
    except v2_exceptions.HttpError as e:
        if e.status == 404:
            # 404表示镜像不存在
            return False
        else:
            # 其他HTTP错误，比如权限不足、网络问题等，可根据需要处理
            print(f"检查镜像时出错：HTTP错误 {e.status}")
            raise
    except Exception as e:
        print(f"检查镜像时发生未知错误：{str(e)}")
        raise

# 示例调用
if __name__ == "__main__":
    # 替换成你的GCR镜像地址，比如gcr.io/your-project/your-image:v1
    target_image = "gcr.io/<project_id>/your-image:latest"
    exists = check_gcr_image_exists(target_image)
    print(f"镜像 {target_image} 是否存在：{exists}")

关键说明 #

• 如果镜像地址没有指定标签，默认会使用latest标签进行检查。
• 若遇到403 Forbidden错误，说明你的认证凭据没有足够的权限访问该镜像或仓库，需要检查服务账号的角色配置。
• 这个库不仅可以检查镜像是否存在，还支持拉取镜像、推送镜像等更多操作，你可以根据需求扩展功能。

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