版本管理提供对实例、命名空间或 OCI 制品仓库下镜像版本的管理，保留策略外的镜像版本将会自动清理。本文介绍如何创建版本保留规则。 ## 前提条件已创建镜像仓库实例。操作详情参见 [创建标准版实例](https://www.volcengine.com/docs/6420/106367)。 ## 操作步骤 :::warning * 版本保留规则执行后，版本保留规则外的存量或新增镜像版本都会被自动清理。 * 被清除镜像版本的存储空间将在任务执行完后的 1~5 小时释放完毕。 * 最多支持启用 10 条保留规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。 ::: 1. 登录 [镜像仓库控制台](https://console.volcengine.com/cr)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏单击 **版本保留**。 4. 在 **版本保留规则** 页面，单击 **创建版本保留规则**。 5. 填写版本保留规则参数。 * **基本信息** |参数 |描述 | |---|---| |名称 |自定义版本保留规则的名称。 | |描述 |填写版本保留规则的描述。 | * **生效范围** |参数 |描述 | |---|---| |生效层级 |支持基于实例、命名空间和 OCI 制品仓库维度制定镜像保留规则。|\ | ||\ | |* 实例：基于实例维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。|\ | |* 命名空间：基于命名空间维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。|\ | |* OCI 制品仓库：基于 OCI 制品仓库维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。 | |实例 |选择保留规则生效的实例。 | |命名空间 |选择保留规则生效的命名空间。 | |OCI 制品仓库 |选择保留规则生效的 OCI 制品仓库，仅清理维度选择 **OCI 制品仓库** 时支持选择。 | * **规则配置** :::tip 保留规则针对每个 OCI 制品仓库单独生效。例如设置保留最新推送的 30 个版本，即所设置的 OCI 制品仓库各保留 30 个版本。 ::: |参数 |描述 | |---|---| |保留规则 |支持按照 **或** 或者 **且 ** 的方式关联条件规则和正则匹配规则。|\ | |:::warning|\ | ||\ | |* 镜像存在 `get manifest` 请求判定为 **拉取**。例如，流水线构建本地缓存，`kubectl` 拉取的镜像存在本地缓存等场景。仅发送 `head manifest` 请求不计为拉取。具体镜像是否最近拉取，以镜像版本的拉取时间为准。|\ | |* 未保留的镜像，清理后无法恢复。如果对客户端行为无法判断，无法确认是否存在镜像本地缓存，且清理后可能导致业务受损等问题，请勿配置 **拉取** 类型策略。|\ | |:::|\ | |* 以版本数量或天数为条件：|\ | | * 以数量为条件：保留最新推送或者拉取的若干个版本。|\ | | * 以天数为条件：保留最近若干天推送或拉取的版本。|\ | |* 正则匹配：支持通过正则表达式保留符合的镜像版本。正则规则筛选的对象为镜像的版本名，例如 `latest` 和 `v1`。常用正则匹配示例参见文末 **正则匹配示例**。|\ | |* 自动清理版本为空的 OCI 制品仓库：开启后，当 OCI 制品仓库内所有镜像版本均被前述保留规则清理时，系统将自动删除该空仓库。 | |规则状态 |支持选择启用或禁用版本保留规则。 | |触发规则 |支持选择手动触发或定时触发版本保留规则。|\ | ||\ | |* 手动触发：需要手动执行规则，实现镜像版本的清理。|\ | |* 定时触发：同时支持手动触发和定时触发，定时触发需要配置以下参数：|\ | | * 首次触发时间：选择首次清理规则外镜像的时间。|\ | | * 触发频率：选择清理镜像的触发周期。 | 7. 配置完成后单击 **确定**，完成创建。 ## 正则匹配示例保留规则支持正则匹配，常用的匹配场景和匹配方式示例如下。 |匹配方式 |匹配目标 |正则表达式 |

|||||\ | | | |匹配目标名称

| | | | |\ | | | | | | | | | |^^|^^|^^|

|\ | | | |v1

|version\-1

|test\-1

|v2

|v3

|\ | | | | | | | | | |---|---|---|---|---|---|---|---| |完全匹配 |仅匹配 `v1` 版本号。 |v1 |

|\ | | | |√

|\-

|\ | | | | | | | | | |前缀匹配 |匹配以 `v` 开头的所有版本号。 |^v.\*$ |

|\ | | | |√

|√

|\-

|√

|\ | | | | | | | | | |多前缀匹配 |匹配以 `v` 或 `t` 开头的所有版本号。 |^(v\|t).\*$ |

|\ | | | |√

|√

|\ | | | | | | | | | |后缀匹配 |匹配以 `-1` 结尾的所有版本号。 |^.\*\-1$ |

|\ | | | |\-

|√

|\-

|\ | | | | | | | | | |多后缀匹配 |匹配以 `1` 或 `2` 结尾的所有版本号。 |^.\*(1\|2)$ |

|\ | | | |√

|√

|\-

|\ | | | | | | | | | |版本号匹配 |匹配以 `v` 开头，连接阿拉伯数字结尾的版本号。 |^v([0\-9.]+)$ |

|\ | | | |√

|\-

|√

|\ | | | | | | | | |