使用gcloud命令无法设置Artifact Registry清理策略

问题详情 #

尝试为Google Cloud Artifact Registry中的Docker仓库设置清理策略，指定的策略文件standard_cleanup_policy.json内容如下：

[
   {
      "name":"delete-older-than-30-days",
      "action":{
         "type":"Delete"
      },
      "condition":{
         "olderThan":"30d"
      }
   },
   {
      "name":"keep-latest-3-images",
      "action":{
         "type":"Keep"
      },
      "mostRecentVersions":{
         "keepCount":3
      }
   }
]

执行gcloud命令：

gcloud artifacts repositories set-cleanup-policies REPOSITORY --location=LOCATION --policy=standard_cleanup_policy.json --project=PROJECT_ID --verbosity debug

命令返回成功，但实际设置的是空策略（输出[]），使用list-cleanup-policies查询返回空，同时Web UI无法添加或更新策略。

调试输出显示命令解析后的--policy参数为对象格式而非数组：

DEBUG: Running [gcloud.artifacts.repositories.set-cleanup-policies] with arguments: [--location: "us", --policy: "{'delete-older-than-30-days': {'id': 'delete-older-than-30-days', 'action': 'Delete', 'condition': {'olderThan': '2592000.0s'}, 'mostRecentVersions': None}, 'keep-latest-3-images': {'id': 'keep-latest-3-images', 'action': 'Keep', 'condition': None, 'mostRecentVersions': {'keepCount': 3}}}", --verbosity: "debug", REPOSITORY: "hypgen"]

核心原因 #

gcloud命令的参数使用错误：--policy用于直接传入内联JSON字符串，而指定JSON文件路径需要使用--policy-file参数。用户误用--policy指定文件路径，导致命令错误解析文件内容，最终设置空策略。

解决方法 #

1. 修正gcloud命令参数 #

将--policy替换为--policy-file，正确命令如下：

gcloud artifacts repositories set-cleanup-policies hypgen --location=us --policy-file=standard_cleanup_policy.json --project=PROJECT_ID --verbosity debug

2. 验证策略格式 #

确保JSON文件结构符合Artifact Registry要求：

• 策略为数组格式，每个元素包含name、action（指定type为Delete或Keep）
• 清理条件按需使用condition（如olderThan）或mostRecentVersions（如keepCount）

3. 替代方案：使用REST API直接更新 #

如果gcloud命令仍有问题，可直接调用Artifact Registry的REST API设置策略：

curl -X PATCH \
  "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories/hypgen?updateMask=cleanup_policies" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "cleanupPolicies": [
      {
        "name": "delete-older-than-30-days",
        "action": {
          "type": "Delete"
        },
        "condition": {
          "olderThan": "30d"
        }
      },
      {
        "name": "keep-latest-3-images",
        "action": {
          "type": "Keep"
        },
        "mostRecentVersions": {
          "keepCount": 3
        }
      }
    ]
  }'

4. 排查Web UI问题 #

• 清除浏览器缓存或使用隐身窗口重试
• 确认账号拥有artifactregistry.repositories.edit权限
• 检查仓库状态是否正常（无锁定、配置异常）

验证策略生效 #

执行以下命令确认策略已正确设置：

gcloud artifacts repositories list-cleanup-policies hypgen --location=us --project=PROJECT_ID

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