配置清理政策

Artifact Registry 清理政策定义了自动删除不再需要的工件版本或保留要无限期存储的工件的条件。

如果您存储了工件的多个版本，但只需要保留发布到生产环境的特定版本，清理政策会非常有用。您可以使用删除工件的条件定义删除政策，并使用保留工件的条件定义保留政策。

如果工件版本同时符合删除政策和保留政策中的条件，则 Artifact Registry 会应用保留政策。

由删除政策触发的删除操作会计入您的 Artifact Registry 每个项目删除请求配额，每个代码库每天的删除次数上限为 30 万次。

政策应用时间表

Artifact Registry 使用定期运行的后台作业删除并保留与您的清理政策匹配的工件。更改将在大约一天后生效。

每个代码库的清理政策数量上限

您最多可以对一个代码库应用 10 项清理政策。

支持的格式

在预览版期间，您可以为标准代码库为所有代码库格式（Apt 和 Yum 除外）设置清理政策。

所需的角色

如需获取应用或移除清理政策所需的权限，请让管理员授予您代码库项目的 Artifact Registry Administrator (roles/artifactregistry.admin) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

此预定义角色包含应用或移除清理政策所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需应用或移除清理政策，您需要具备以下权限：

artifactregistry.repositories.update
如需删除符合清理政策条件的工件，请执行以下操作： artifactregistry.versions.delete

您也可以使用自定义角色或其他预定义角色来获取这些权限。

Artifact Registry Service Agent 的默认角色包含 artifactregistry.versions.delete 权限，若要删除满足清理政策条件的映像，此权限必不可少。

创建政策文件

政策文件是一种 JSON 文件，用于定义删除和保留政策。如需创建政策文件，您可以先创建和修改 JSON 文件，然后使用 Google Cloud CLI 应用政策，或者使用 Google Cloud 控制台。删除政策指定删除工件的条件。Keep 政策用于指定保留工件的条件，或要保留的多个近期版本。您不能在同一 Keep 政策中同时使用条件和最新版本。

创建删除政策

借助删除政策，您可以指定删除工件的最短或最长存在时间，以及额外的过滤条件，以便将政策限制为仅适用于特定工件。

控制台

您可以为新代码库或现有代码库创建删除政策。

如需向现有代码库添加删除政策，请执行以下操作：

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，选择试运行以测试新政策，然后再提交删除任何工件。如需详细了解如何查看测试结果，请参阅试运行。

确定您的政策按预期运行后，再次修改代码库设置，然后选择删除工件以应用清理政策并删除所选的工件。
点击添加清理政策，然后添加以下内容：
- 名称：为清理政策命名。该名称在应用于代码库的政策组中必须是唯一的。
- 政策类型：选择条件删除。
- 标记状态：指明政策应检查已加标签的工件还是未标记的工件。在向代码库推送映像或从代码库拉取映像时，系统会对工件进行标记。如需详细了解 Docker 标记，请参阅容器概念。
  - 任何标记状态：忽略标记状态，并且同时适用于已标记和未标记的工件。
  - 已添加标记：仅适用于已标记的工件。
  - 未标记：仅适用于未添加标记的工件。
  不支持标记的格式将被视为 untagged。如需详细了解适用于清理政策的标记状态，请参阅 TagState 参考文档。
以下是定义删除政策的可选方法：
- 标记前缀：以英文逗号分隔的标记前缀列表。例如，前缀 test 和 staging 将与具有标记 testenv 和 staging-1.5 的映像匹配。tagState 必须设置为 TAGGED 才能使用标记前缀。
- 版本前缀：- 是以英文逗号分隔的工件版本前缀列表。例如，v1、v2 将匹配版本 v1.5、v2.0alpha 和 v10.2。
- 软件包前缀：列出了工件名称前缀。您可以输入多个前缀，只需在前缀之间按 Enter 或 , 即可。例如，red, blue 将创建两个前缀：red 和 blue，并与工件名称 red-team、redis 和 bluebird 匹配。
- 早于：自工件版本上传到代码库以来的最短时间，以时长的形式指定。例如，30d 为 30 天。您可以通过分别附加 s、m、h 或 d 来指定时长（秒、分钟、小时或天）。
- 晚于：自工件版本上传到代码库以来的最长时间，以时长的形式指定。例如，30d 为 30 天。
您可以点击添加清理政策来添加更多清理政策。
点击更新。

您的清理政策会应用于代码库。您可以点击展开，在代码库详情部分中查看清理政策。

JSON

{
  "name": "DELETE_POLICY_NAME",
  "action": {"type": "Delete"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

删除政策必须包含名称、操作和至少一个条件。

name: 在删除政策代码段中，DELETE_POLICY_NAME 是政策的名称。该名称在应用于代码库的政策组中必须是唯一的。
action: 对于删除政策，该值为 {"type": "Delete"}。
condition: 指定以下一个或多个条件

tagState：TAG_STATUS 指示政策应检查已标记工件还是未标记工件。在向代码库推送映像或从代码库拉取映像时，系统会对工件进行标记。如需详细了解 Docker 标记，请参阅容器概念。支持的值包括：tagged、untagged 或 any。不支持标记的格式将被视为 untagged。
tagPrefixes：TAG_PREFIXES 是以英文逗号分隔的标记前缀列表。例如，"test", "staging" 将匹配具有 "testenv" 和 "staging-1.5" 标记的图片。tagState 必须设置为 TAGGED 才能使用标记前缀。
versionNamePrefixes：VERSION_PREFIXES 是以英文逗号分隔的工件版本前缀列表。例如，"v1", "v2" 将匹配版本 "v1.5"、"v2.0alpha" 和 "v10.2"。
packageNamePrefixes：PACKAGE_PREFIXES 是以英文逗号分隔的工件名称前缀列表。例如，"red", "blue" 将与工件名称 "red-team"、"redis" 和 "bluebird" 匹配。
olderThan：OLDER_THAN_DURATION 是自工件版本上传到代码库以来的最短时间，以时长的形式指定。例如，30d 为 30 天。您可以通过分别附加 s、m、h 或 d 来指定时长（秒、分钟、小时或天）。
newerThan：NEWER_THAN_DURATION 是自工件版本上传到代码库以来的最长时间，指定为时长。例如，30d 为 30 天。

创建条件保留政策

条件式保留政策用于指定保留工件的条件。

控制台

您可以为新代码库或现有代码库创建 Keep 政策。

如需向现有代码库添加 Keep 政策，请执行以下操作：

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，选择试运行以测试新政策，然后再提交删除任何工件。您需要设置至少一个删除政策才能查看保留政策的结果。如需详细了解如何查看测试结果，请参阅试运行。

确定政策按预期运行后，再次修改代码库设置，然后选择删除工件以应用清理政策并删除所选的工件。
点击添加清理政策，然后添加以下内容：
- 名称：为清理政策命名。该名称在应用于代码库的政策组中必须是唯一的。
- 政策类型：选择条件保留。
- 标记状态：指明政策应检查已加标签的工件还是未标记的工件。在向代码库推送映像或从代码库拉取映像时，系统会对工件进行标记。如需详细了解 Docker 标记，请参阅容器概念。
  - 任何标记状态：忽略标记状态，并且同时适用于已标记和未标记的工件。
  - 已添加标记：仅适用于已标记的工件。
  - 未标记：仅适用于未添加标记的工件。
  不支持标记的格式将被视为 untagged。如需详细了解适用于清理政策的标记状态，请参阅 TagState 参考文档。
以下是定义 Keep 政策的可选方法：
- 标记前缀：以英文逗号分隔的标记前缀列表。例如，前缀 test 和 staging 将与具有标记 testenv 和 staging-1.5 的映像匹配。tagState 必须设置为 TAGGED 才能使用标记前缀。
- 版本前缀：- 是以英文逗号分隔的工件版本前缀列表。例如，v1、v2 将匹配版本 v1.5、v2.0alpha 和 v10.2。
- 软件包前缀：以逗号分隔的工件名称前缀列表。例如，red, blue 将匹配工件名称 red-team、redis 和 bluebird。
注意：如果指定了软件包前缀，Artifact Registry 将仅保留与指定软件包前缀匹配的软件包的最新版本。
- 早于：自工件版本上传到代码库以来的最短时间，以时长的形式指定。例如，30d 为 30 天。您可以通过分别附加 s、m、h 或 d 来指定时长（秒、分钟、小时或天）。
- 晚于：自工件版本上传到代码库以来的最长时间，以时长的形式指定。例如，30d 为 30 天。
您可以点击添加清理政策来添加更多清理政策。
点击更新。

您的清理政策会应用于代码库。

JSON

格式与删除政策类似。对于 Keep 政策，action 的值为 {"type": "Keep"}。

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

替换以下内容：

使用清理政策命名的 KEEP_POLICY_NAME。该名称在应用于代码库的政策组中必须是唯一的。
将 TAG_STATUS 替换为标记状态，用于指示政策应检查已加标签的工件还是未标记的工件。将映像推送到代码库或从代码库拉取映像时，系统会对工件进行标记。如需详细了解 Docker 标记，请参阅容器概念。

以下是各个选项：
- tagged：仅适用于带标记的工件。
- untagged：仅适用于未添加标记的工件。
- any：适用于所有版本
不支持标记的格式将被视为 untagged。如需详细了解适用于清理政策的标记状态，请参阅 TagState 参考文档。
TAG_PREFIXES 替换为逗号分隔的标记前缀列表。例如，前缀 test 和 staging 将与具有标记 testenv 和 staging-1.5 的映像匹配。tagState 必须设置为 TAGGED 才能使用标记前缀。
VERSION_PREFIXES 替换为逗号分隔的工件版本前缀列表。例如，v1, v2 将匹配版本 v1.5、v2.0alpha 和 v10.2。
PACKAGE_PREFIXES 替换为以英文逗号分隔的工件名称前缀列表。例如，red, blue 将匹配工件名称 red-team、redis 和 bluebird。

OLDER_THAN_DURATION：自工件版本上传到代码库以来的最短时间，指定为时长。例如，30d 为 30 天。您可以通过分别附加 s、m、h 或 d 来指定时长（秒、分钟、小时或天）。
NEWER_THAN_DURATION：自工件版本上传到代码库以来的最长时间，指定为时长。例如，30d 为 30 天。

创建最新版本的保留政策

您可以创建保留政策以保留特定数量的版本。您不能在同一保留政策中同时使用条件保留和保留最新版本条件。

控制台

您可以为新代码库或现有代码库创建保留最新版本的政策。

如需将保留最新版本的政策添加到现有代码库，请执行以下操作：

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，选择试运行以测试新政策，然后再提交删除任何工件。您需要设置至少一个删除政策才能查看保留政策的结果。如需详细了解如何查看测试结果，请参阅试运行。

确定政策按预期运行后，再次修改代码库设置，然后选择删除工件以应用清理政策并删除所选的工件。
点击添加清理政策，然后添加以下内容：
- 名称：为清理政策命名。该名称在应用于代码库的政策组中必须是唯一的。
- 政策类型：选择保留最新版本。
在保留计数字段中，输入要在代码库中保留的工件的版本数。
可选：选择软件包前缀，指定要应用保留政策的软件包前缀。例如，red, blue 将匹配工件名称 red-team、redis 和 bluebird。

注意：如果指定了软件包前缀，Artifact Registry 将仅保留与指定软件包前缀匹配的软件包的最新版本。
您可以点击添加清理政策来添加更多清理政策。
点击更新。

您的清理政策会应用于代码库。您可以点击展开，在代码库详情部分中查看清理政策。

JSON

格式与删除政策类似。对于 Keep 政策，action 的值为 {"type": "Keep"}。

用于保留特定数量版本的 Keep 政策具有 mostRecentVersions 部分，而不是 condition 部分。

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "mostRecentVersions": {
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "keepCount": MINIMUM_NUMBER
  }
}

替换以下内容：

将 KEEP_POLICY_NAME 替换为您的 keep 政策的名称。该名称在应用于代码库的政策组中必须是唯一的。
PACKAGE_PREFIXES 替换为要应用保留政策的可选软件包前缀。例如，red, blue 将匹配工件名称 red-team、redis 和 bluebird。

将 MINIMUM_NUMBER 替换为代码库中要保留的工件的版本数量。

如需将保留政策应用于代码库中的所有软件包，请省略 packageNamePrefixes 条件。代码库中每个软件包的指定数量最新版本会保留。

政策文件示例

以下政策文件示例具有一项删除政策和两项保留政策。

如果工件以字符串 alpha 或 v0 开头，delete-prerelease 政策会在上传 30 天后移除工件版本。
keep-tagged-release 政策保留使用前缀 release 标记且文件名以 webapp 或 mobile 开头的工件。
keep-minimum-versions 政策保留文件名以 webapp、mobile 或 sandbox 开头的工件的五个最新版本。

[
  {
    "name": "delete-prerelease",
    "action": {"type": "Delete"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["alpha", "v0"],
      "olderThan": "30d"
    }
  },
  {
    "name": "keep-tagged-release",
    "action": {"type": "Keep"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["release"],
      "packageNamePrefixes": ["webapp", "mobile"]
    }
  },
  {
    "name": "keep-minimum-versions",
    "action": {"type": "Keep"},
    "mostRecentVersions": {
      "packageNamePrefixes": ["webapp", "mobile", "sandbox"],
      "keepCount": 5
    }
  }
]

通过试运行测试您的政策

如需测试清理政策，您可以将清理政策设置为在控制台中试运行，也可以运行带有 --dry-run 标志的 gcloud artifacts set-cleanup-policies 命令。

如需分析清理政策的效果，您可以查看 Artifact Registry 数据访问审核日志。如需接收清理政策的数据访问审核日志，您必须明确启用数据访问审核日志的数据写入类型。如需启用数据访问审核日志，请参阅启用审核日志。

控制台

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，选择试运行。
点击添加清理政策，然后配置条件删除、条件保留或保留最新版本政策的选项。
点击更新。

当删除政策导致 BatchDeleteVersions 操作时，参数 validateOnly 的求值结果为 "true"。

如需查询清理政策的试运行审核日志，请运行以下命令：

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

输出类似以下内容：

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

gcloud CLI

如需使用您的清理政策执行试运行，请运行以下命令：

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --dry-run

替换以下内容：

将 REPOSITORY 替换为代码库的名称。
将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
将 LOCATION 替换为代码库的单区域或多区域位置。

当删除政策导致 BatchDeleteVersions 操作时，参数 validateOnly 的求值结果为 "true"。

如需查询清理政策的试运行审核日志，请运行以下命令：

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

输出类似以下内容：

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

将政策应用于代码库

在 Google Cloud 控制台中创建的清理政策在创建或更新时应用。

如需使用在本地 JSON 文件中定义的清理政策，请使用 gcloud CLI 将清理政策应用于您希望 Artifact Registry 在其中处理自动删除工件版本的代码库。

您只能对标准代码库应用清理政策。您不能将清理政策应用于以下各项：

Google Cloud 项目
虚拟代码库。

如需应用清理政策，请在包含清理政策文件的目录中运行以下命令。

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

替换以下内容：

将 REPOSITORY 替换为代码库的名称。
将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
将 LOCATION 替换为代码库的单区域或多区域位置。
--no-dry-run 用于停用代码库的试运行功能。
POLICY_FILE 是具有清理政策的文件的名称。

例如，以下命令会将 policy.json 中的政策应用于项目 my-project 内 us-east1 区域中的代码库 my-repo。

gcloud artifacts repositories set-cleanup-policies my-repo \
    --project=my-project \
    --location=us-east1 \
    --policy=policy.json

Artifact Registry 使用定期运行的后台作业删除并保留与您的政策匹配的工件。更改将在大约一天后生效。

更新政策

控制台

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，点击要设置修改的政策的名称。
修改清理政策，然后点击更新。

您的清理政策会应用于代码库。

gcloud CLI

如需更新现有政策，请修改政策文件中的设置，然后运行以下命令再次应用政策。

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

替换以下内容：

将 REPOSITORY 替换为代码库的名称。
将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
将 LOCATION 替换为代码库的单区域或多区域位置。
--no-dry-run 用于停用代码库的试运行功能。
POLICY_FILE 是具有清理政策的文件的名称。

列出代码库清理政策

您可以查看与代码库关联的清理政策。

控制台

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择要查看的代码库。
在代码库详细信息部分中，点击展开。

系统会显示清理政策名称。
如需查看或修改代码库的清理政策的详细信息，请点击修改代码库。

清理政策部分列出了您现有的清理政策详细信息。

gcloud CLI

运行以下命令：

gcloud artifacts repositories list-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION

替换以下内容：

将 REPOSITORY 替换为代码库的名称。
将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
将 LOCATION 替换为代码库的单区域或多区域位置。

从代码库中移除政策

当您不再希望 Artifact Registry 自动删除工件版本时，请从代码库中移除清理政策。

控制台

打开 Google Cloud 控制台中的制品库页面。

打开“代码库”页面
在代码库列表中，选择相应代码库，然后点击修改代码库。
在清理政策部分中，将鼠标悬停在要删除的政策的名称上。
点击删除图标。
点击更新。

清理政策将被删除。

gcloud CLI

运行以下命令：

gcloud artifacts repositories delete-cleanup-policies REPOSITORY \
    --policynames=POLICY_NAMES \
    --project=PROJECT_ID \
    --location=LOCATION

替换以下内容：

REPOSITORY 是代码库的名称。
PROJECT_ID 是您的 Google Cloud 项目的 ID。
LOCATION 是代码库的单区域或多区域位置。
POLICY_NAMES 是要移除的政策对应的政策名称列表（以英文逗号分隔）。

例如，以下命令会从项目 my-project 内 us-east1 区域中的代码库 my-repo 中移除名为 delete-test 的政策：

gcloud artifacts repositories delete-cleanup-policies my-repo \
    --policynames=delete-test \
    --project=my-project \
    --location=us-east1

清理政策的审核日志条目

如需在 Cloud Logging 中查看清理政策日志条目，您必须enable DATA_WRITE 日志记录。

对代码库设置清理政策时，系统会将操作记录为对代码库的更新（UpdateRepository 操作）。

当 Artifact Registry 删除工件的某个版本时，它会在 Cloud Logging 数据访问日志中记录该事件。日志条目显示 Artifact Registry 服务帐号执行了删除操作。Artifact Registry 服务帐号 ID 的格式为 service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com

其他工具

对于容器映像，您还可以使用以下工具进行映像生命周期管理：

gcrane：适用于容器注册表的工具，您可以使用它在代码库之间复制映像。
gcr-cleaner：用于根据指定条件删除容器映像的工具。

gcrane 和 gcr-cleaner 工具不是 Google 官方产品。