使用gcloud删除Artifacts版本/摘要后仓库空间未释放问题咨询

针对你遇到的gcloud命令删除镜像后仓库大小未缩减的问题，可能是以下几个原因导致，对应解决步骤如下：

1. 镜像层被其他版本共享 #

Artifacts Registry会复用相同的镜像层，如果你删除的版本和仓库中其他保留的版本共享底层镜像层，这些共享层不会被删除，仓库自然不会释放空间。而控制台删除时可能你清理的是最后一个引用该层的版本。

• 验证方式：执行以下命令查看镜像的引用关联：

  gcloud artifacts docker images list-tags <REGION>-docker.pkg.dev/<PROJECT_ID>/<REPO_NAME>/<IMAGE_NAME> --show-occurrences
  

  输出中会显示每个标签/摘要对应的引用情况，确认是否有其他版本仍在使用目标层。

2. 垃圾回收未即时触发 #

gcloud命令删除版本后，Artifacts Registry的垃圾回收（GC）默认是异步且延迟执行的，而控制台删除可能触发了更即时的GC流程，或者你在控制台操作后等待了足够久的时间。

• 手动触发垃圾回收：
  1. 创建GC策略文件policy.json，示例内容：

     {
       "rules": [
         {
           "action": "DELETE",
           "condition": {
             "age": "30d",
             "unusedFor": "7d"
           },
           "groupBy": ["package"],
           "priority": 1
         }
       ]
     }
     

  2. 应用策略并触发GC：

     gcloud repositories set-policy <REPO_NAME> --repository-format=docker --location=<REGION> --policy-file=policy.json
     gcloud artifacts repositories run-gc <REPO_NAME> --location=<REGION>
     

  注意：执行run-gc需要服务账号拥有artifacts.repositories.runGc权限。

3. gcloud命令参数使用不当 #

确保你使用的命令参数完整且正确：

• 正确的镜像删除命令需指定完整的镜像路径（标签或摘要），并添加--force确保彻底删除：

  gcloud artifacts docker images delete <REGION>-docker.pkg.dev/<PROJECT_ID>/<REPO_NAME>/<IMAGE_NAME>:<TAG> --delete-tags --force
  

  避免只删除标签但保留镜像摘要的情况——如果仅删标签，镜像的摘要版本仍会占用空间。

4. Cloud Build服务账号权限不足 #

Cloud Build流水线使用的服务账号可能缺少必要的权限，导致删除操作未完全触发空间释放流程：

• 检查服务账号的IAM权限，确保它拥有artifacts.repositories.deleteArtifacts和artifacts.repositories.runGc权限，或直接授予Artifact Registry Administrator角色。

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