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

前提条件

已创建镜像仓库实例。操作详情参见 创建远端代理仓。

操作步骤

1. 登录 镜像仓库控制台。

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

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

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

5. 填写版本保留规则参数。

   • 基本信息

   

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

   • 生效范围

   

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

   • 规则配置

   

   说明

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

   参数	描述
   保留规则	支持三种类型的保留规则。 保留最新推送的若干个版本：支持设置的版本个数为 1 ~100000。 保留最近若干天推送的版本：支持设置的天数为 1~365。 正则匹配：支持通过正则表达式保留符合的镜像版本。正则规则筛选的对象为镜像的版本名，例如 latest 和 v1。常用正则匹配示例参见文末 正则匹配示例。
   规则状态	支持选择启用或禁用版本保留规则。
   触发规则	支持选择手动触发或定时触发版本保留规则。 手动触发：需要手动执行规则，实现镜像版本的清理。 定时触发：同时支持手动触发和定时触发，定时触发需要配置以下参数： 首次触发时间：选择首次清理规则外镜像的时间。 触发频率：选择清理镜像的触发周期，单位为小时，范围为 1~720。

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

   

正则匹配示例

保留规则支持正则匹配，常用的匹配场景和匹配方式示例如下。