文档中心

镜像仓库

版本保留规则

创建版本保留规则

版本管理提供对实例、命名空间或 OCI 制品仓库下镜像版本的管理，保留策略外的镜像版本将会自动清理。本文介绍如何创建版本保留规则。

说明

本操作仅适用于标准实例，不适用于远端代理仓。

前提条件

已创建镜像仓库实例。操作详情参见创建标准版实例。

操作步骤

注意

首次推送的镜像存在两小时版本保护期，保护期内不会被清理。

版本保留规则执行后，版本保留规则外的存量或新增镜像版本都会被自动清理。

被清除镜像版本的存储空间将在任务执行完后的 1~5 小时释放完毕。

最多支持启用 10 条保留规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。

登录镜像仓库控制台。

在顶部导航栏，选择目标地域。

在左侧导航栏单击版本保留。

在版本保留规则页面，单击创建版本保留规则。

填写版本保留规则配置信息。

基本信息

参数
描述
名称
自定义版本保留规则的名称。
描述
填写版本保留规则的描述。

生效范围

参数	描述
生效层级	支持基于实例、命名空间和 OCI 制品仓库维度制定镜像保留规则。实例：基于实例维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。命名空间：基于命名空间维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。 OCI 制品仓库：基于 OCI 制品仓库维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。
实例	选择保留规则生效的实例。
命名空间	选择保留规则生效的命名空间。
OCI 制品仓库	选择保留规则生效的 OCI 制品仓库，仅生效范围选择 OCI 制品仓库时支持选择。

规则配置

说明

保留规则针对每个 OCI 制品仓库单独生效。例如设置保留最新推送的 30 个版本，即所设置的 OCI 制品仓库各保留 30 个版本。

参数	描述
保留规则	支持按照或或者且的方式关联条件规则和正则匹配规则。注意镜像存在 get manifest 请求判定为拉取。例如，流水线构建本地缓存，kubectl 拉取的镜像存在本地缓存等场景。仅发送 head manifest 请求不计为拉取。具体镜像是否最近拉取，以镜像版本的拉取时间为准。未保留的镜像，清理后无法恢复。如果对客户端行为无法判断，无法确认是否存在镜像本地缓存，且清理后可能导致业务受损等问题，请勿配置拉取类型策略。以版本数量或天数为条件：以数量为条件：保留最新推送或者拉取的若干个版本。以天数为条件：保留最近若干天推送或拉取的版本。正则匹配：支持通过正则表达式保留符合的镜像版本。正则规则筛选的对象为镜像的版本名，例如 latest 和 v1。常用正则匹配示例参见正则匹配示例。自动清理版本为空的 OCI 制品仓库：开启后，当 OCI 制品仓库内所有镜像版本均被前述保留规则清理时，系统将自动删除该空仓库。
规则状态	支持选择启用或禁用版本保留规则。
触发规则	支持选择手动触发或定时触发版本保留规则。手动触发：需要手动执行规则，实现镜像版本的清理。定时触发：同时支持手动触发和定时触发，定时触发需要配置以下参数：首次触发时间：选择首次清理规则外镜像的时间。触发频率：选择清理镜像的触发周期。

配置完成后单击确定，完成创建。

最近更新时间：2026.06.02 15:08:19

这个页面对您有帮助吗？

有用

无用

参数	描述
名称	自定义版本保留规则的名称。
描述	填写版本保留规则的描述。