镜像在业务演进的过程中会产生新的版本，随着镜像版本数量的增加，所消耗的存储成本和系统配额也会随之增加，最终导致镜像推送失败。定期清除不需要的镜像版本可以有效避免此类问题。 ## 场景介绍镜像仓库中每个 OCI 制品仓库可保存的镜像版本（Tag）数量有限，**存储的镜像版本超过限制后，新的镜像版本无法上传**。过多的镜像版本即会加大镜像维护的工作量，也会加大存储的成本。建议您使用 [版本保留规则](https://console.volcengine.com/cr/region:cr+cn-beijing/tagretention?)，自动清理镜像版本，保证镜像版本配额的充足，以免影响镜像的上传。本文以正则匹配维度的清理策略为例，在 **`repo`** ** OCI 制品仓库**，**每周日的零时** 保留版本号 **以 tag 开头** 的镜像，即保留例如 `tag1` 、`tag2` 等版本的镜像。 ## 功能介绍镜像清理的方式十分灵活，可以满足不同场景中的镜像清理需求。当前支持基于数量维度、时间维度和正则匹配维度，在实例、命名空间或 OCI 制品仓库中清理镜像。 * 清理方式 * 数量维度：仅保留最新推送的若干个版本，清理其他的版本。例如保留最新的 100 个镜像版本。 * 时间维度：仅保留最近若干天推送的版本，清理其他的版本。例如保留最近 1 个月的镜像版本。 * 正则匹配：通过正则表达式保留所需的镜像版本。正则表达式筛选的对象为镜像的版本名，例如 `latest` 和 `v*`。 * 清理维度 * 实例维度：单个实例维度执行清理。 * 命名空间：单个命名空间维度执行清理。 * OCI 制品仓库：指定命名空间中的一个或多个 OCI 制品仓库执行清理。 ## 前提条件已上传镜像至目标制品仓库，操作方法参见 [使用标准版实例拉取和推送镜像](https://www.volcengine.com/docs/6420/79746)。 ## 操作步骤 ### 步骤一：创建版本保留规则 1. 登录 [镜像仓库控制台](https://console.volcengine.com/cr)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏单击 **版本管理** \> **版本保留规则**。 4. 在 **版本保留规则** 页面，单击 **创建版本保留规则**。 5. 填写版本保留规则参数。本示例参数配置如下图所示，效果为在 **`repo`** ** OCI 制品仓库**，**每周日的零时** 删除版本号 **不以 tag 开头** 的镜像。参数配置详细说明参见 [版本保留规则管理](https://www.volcengine.com/docs/6420/156295)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3f44b1d388d5702b1c37ffc4ebf97513.png) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9da5ad67db0287909318b858f91c980d.png) 6. 单击 **确定**，完成操作。 ### 步骤二：执行规则已设定定时执行的规则也支持手动触发。 * **自动执行**：支持按照本示例设置的每周日零时自动执行清理。在版本保留规则列表页面的 **触发方式** 列，可查看定时执行的具体时间。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eeba46db860760e3f390edd547efd7fd.png) * **手动执行**：您可以可手动触发镜像清理。在版本保留规则列表页面，单击 **操作** 列下的 **执行**，在二次确认页面单击 **确定**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dcd6c4d12e3d5e3a870a88692cf47d4c.png) ### 步骤三：查看清理记录 1. 在 **版本保留规则** 页面单击目标规则的名称。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_75ab8225054c47302b8a6d135091ce08.png) 2. 单击目标执行任务的 ID，查看已保留或已清理的镜像信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8bcdda3c9a73ae0dd3a73f400be03932.png) ## 结果验证如果图所示，已按照创建的版本保留规则，保留了 `tag1`、`tag2 和 tag3` 镜像版本，清理了其他的镜像版本。 * **清理前** ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f824699de63e4a830ab53d52d87ffdbe.png) * **清理后** ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_56a0dd3ee5c6bcd6786a26cc996ef308.png) ## 常用正则匹配规则 |正则规则 |含义 | |---|---| |^release\-([0\-9.]+)$ |以 `release-` 和阿拉伯数字拼接而成的镜像版本号，例如 `release-1`。 | |^([0\-9.]+)$ |以阿拉伯数字为前缀的镜像版本号，例如 `1`、`11` 等。 | |^tag.\* |以 `tag` 为前缀的镜像版本号，例如 `tag2`。 |