版本保留规则管理
最近更新时间：2024.02.02 09:15:34
首次发布时间：2021.11.11 21:06:11
版本管理提供对实例、命名空间或 OCI 制品仓库下镜像版本的管理，保留策略外的镜像版本将会自动清理。本文介绍如何创建和管理版本保留规则。
创建版本管理规则
注意
- 版本保留规则执行后，版本保留规则外的存量或新增镜像版本都会被自动清理。
- 被清除镜像版本的存储空间将在任务执行完后的 1~5 小时释放完毕。
- 最多支持启用 10 条保留规则，超出限制后新建的规则为禁用状态。如需开启请先禁止或删除存量的规则。
登录 镜像仓库控制台。
在顶部导航栏，选择目标地域。
在左侧导航栏单击 版本保留。
在 版本保留规则 页面，单击 创建版本保留规则。
填写版本保留规则参数。
- 基本信息
参数 描述 名称 自定义版本保留规则的名称。 描述 填写版本保留规则的描述。 - 生效范围
参数 描述 生效层级 支持基于实例、命名空间和 OCI 制品仓库维度制定镜像保留规则。 - 实例：基于实例维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。
- 命名空间：基于命名空间维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。
- OCI 制品仓库：基于 OCI 制品仓库维度制定镜像版本保留规则，清理规则外的存量和新增镜像版本。
实例 选择保留规则生效的实例。 命名空间 选择保留规则生效的命名空间。 OCI 制品仓库 选择保留规则生效的 OCI 制品仓库，仅清理维度选择 OCI 制品仓库 时支持选择。 - 规则配置
说明
保留规则针对每个 OCI 制品仓库单独生效。例如设置保留最新推送的 30 个版本，即所设置的 OCI 制品仓库各保留 30 个版本。
参数 描述 保留规则 支持三种类型的保留规则。 - 保留最新推送的若干个版本：支持设置的版本个数为 1 ~100000。
- 保留最近若干天推送的版本：支持设置的天数为 1~365。
- 正则匹配：支持通过正则表达式保留符合的镜像版本。正则规则筛选的对象为镜像的版本名，例如
latest和v1。常用正则匹配示例参见文末 正则匹配示例。
规则状态 支持选择启用或禁用版本保留规则。 触发规则 支持选择手动触发或定时触发版本保留规则。 - 手动触发：需要手动执行规则，实现镜像版本的清理。
- 定时触发：同时支持手动触发和定时触发，定时触发需要配置以下参数：
- 首次触发时间：选择首次清理规则外镜像的时间。
- 触发频率：选择清理镜像的触发周期，单位为小时，范围为 1~720。
配置完成后单击 确定，完成创建。
管理版本保留规则
支持对已创建的版本保留规则进行手动执行、禁用、编辑和删除操作。
登录 镜像仓库控制台。
在顶部导航栏，选择目标地域。
在左侧导航栏单击 版本保留。
在目标规则的 操作 列，执行规则管理操作。
操作 说明 执行 即时触发保留规则，执行镜像清理操作，对应的存储空间将在任务执行完后 1-5 小时释放完毕。 - 触发模式为 手动触发 的规则，仅支持通过 执行 触发镜像的清理。
- 触发模式为 定时触发 的规则，同样支持通过即时执行的方式新增一次镜像清理操作。
禁用 禁用已启用的规则。当前最多支持启用 10 条保留规则，超出限制后新建的规则为禁用状态。支持通过禁止的方式释放启用配额。 编辑 更新版本保留规则的配置信息。支持更新规则的名称、生效的命名空间、OCI 制品仓库、镜像保留的方式、触发规则等信息。不支持更新规则生效的实例。 删除 删除暂不需要的规则，释放资源空间。当前最多支持启用 10 条保留规则，超出限制后新建的规则为禁用状态。支持通过删除的方式释放启用配额。
查看规则执行历史
支持查看版本保留规则的执行历史。
登录 镜像仓库控制台。
在顶部导航栏，选择目标地域。
在左侧导航栏单击 版本保留。
单击目标规则的名称。
查看执行任务的信息。
参数 名称 任务 ID 保留版本规则任务的 ID。支持单击 ID 查看镜像清理的详情。 执行状态 执行的状态，当前支持 - 等待中：任务已触发，但是上次一个任务未完成。待前置的任务完成后，切换为 执行中 状态。
- 执行中：正在执行镜像清理任务。
- 成功：已完成任务，支持单击任务 ID 查看镜像清理的详情。
- 失败：任务执行失败。请通过报错信息进行排查或 提交工单。
执行进度 镜像清理的进度，展示 清理成功数量/总清理数量 的数值。 执行方式 规则执行的方式。 - 手动触发：即时触达任务的执行。可以通过控制台的 执行 操作完成。
- 定时触发：根据已设定的定时触发时间执行任务。
任务创建时间 任务创建的时间。 执行开始时间 任务开启执行的时间。 执行结束时间 任务结束执行的时间。 单击目标执行任务的 ID，查看已保留或已清理的镜像信息。
正则匹配示例
| 匹配方式 | 匹配目标 | 正则表达式 | 匹配目标名称 | ||||
|---|---|---|---|---|---|---|---|
| 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.]+)$ | √ | - | - | √ | √ |