全部产品
Search
文档中心

容器镜像服务 ACR:清理制品版本

更新时间:Jul 31, 2026

镜像多次构建后,旧版本持续占用OSS存储空间并产生额外费用。ACR企业版支持通过版本保留策略批量清理不再需要的制品版本。

设置版本保留策略

设置制品版本保留策略后,保留策略外的制品版本将被清理。

  1. 登录容器镜像服务控制台

  2. 在顶部菜单栏,选择所需地域。

  3. 在左侧导航栏,选择实例列表

  4. 实例列表页面单击目标企业版实例。

  5. 在企业版实例管理页面的左侧导航栏选择仓库管理 > 版本管理

  6. 版本管理页面单击创建保留策略

  7. 创建保留策略对话框,清理范围配置向导中设置参数,单击下一步

    参数

    说明

    清理范围

    实例命名空间仓库清理制品版本。

    • 实例:清理范围为该实例下的所有仓库,每个仓库均保留指定的制品版本。

    • 命名空间:清理范围为该命名空间下的所有仓库,每个仓库均保留指定的制品版本。

    • 仓库:清理范围为指定仓库。需同时选择命名空间和仓库。

      说明

      若选择仓库后仅指定命名空间、不选具体仓库,则清理范围为该命名空间下的所有仓库。

    执行方式

    • 自动:支持每周和每月定时触发镜像清理任务,清理制品版本。

    • 手动:需要手动触发镜像清理任务,具体操作,请参见手动触发版本清理任务

    执行周期

    选择自动执行的执行周期。支持按每周每月执行镜像清理任务。

    说明

    仅选择执行方式自动时,才需配置该项。

  8. 保留策略配置向导中配置参数,然后单击创建保留策略

    参数

    说明

    保留最近推送的镜像(必填)

    保留最近推送的镜像数量。超出该数量的旧版本将被清理。

    保留制品版本(选填)

    通过正则表达式额外保留符合命名规则的制品版本,不受上述数量限制。默认值为 .*,表示保留所有制品版本。示例:

    • release-v.*:保留所有以 release-v 开头的版本(适用于正式发布版本)

    • stable-.*:保留所有以 stable- 开头的制品版本(适用于长期稳定版本)。

手动触发版本清理任务

  1. 登录容器镜像服务控制台

  2. 在顶部菜单栏,选择所需地域。

  3. 在左侧导航栏,选择实例列表

  4. 实例列表页面单击目标企业版实例。

  5. 在企业版实例管理页面的左侧导航栏选择仓库管理 > 版本管理

  6. 版本管理页面单击目标保留策略操作列的立即执行

  7. 提示对话框中单击确定

后续步骤

清理企业版实例的制品版本后,制品版本占用的OSS Bucket存储空间仍然存在。若需释放该存储空间,请执行制品清理任务。具体操作,请参见清理OSS存储空间

常见问题

ACR 个人版实例如何清理制品版本?

ACR 企业版和个人版的制品版本清理方式不同:

  • 企业版:支持通过版本保留策略自动清理制品版本。您可以配置保留策略,系统将定期自动清理策略范围外的制品版本。具体操作,请参见设置版本保留策略

  • 个人版:不支持版本保留策略,无法自动清理制品版本。登录容器镜像服务控制台,在个人版实例的镜像仓库页面手动删除不再需要的制品版本。