文档中心

镜像仓库

最佳实践

清理镜像版本

镜像在业务演进的过程中会产生新的版本，随着镜像版本数量的增加，所消耗的存储成本和系统配额也会随之增加，最终导致镜像推送失败。定期清除不需要的镜像版本可以有效避免此类问题。

场景介绍

镜像仓库中每个 OCI 制品仓库可保存的镜像版本（Tag）数量有限，存储的镜像版本超过限制后，新的镜像版本无法上传。过多的镜像版本即会加大镜像维护的工作量，也会加大存储的成本。建议您使用版本保留，自动清理镜像版本，保证镜像版本配额的充足，以免影响镜像的上传。

本文以正则匹配维度的清理策略为例，在 repo OCI 制品仓库，每周日的零时保留版本号以 tag 开头的镜像，即保留例如 tag1 、tag2 等版本的镜像。

功能介绍

镜像清理的方式十分灵活，可以满足不同场景中的镜像清理需求。当前支持基于数量维度、时间维度和正则匹配维度，在实例、命名空间或 OCI 制品仓库中清理镜像。

前提条件

已上传镜像至目标制品仓库，操作方法参见使用标准版实例拉取和推送镜像。

操作步骤

步骤一：创建版本保留规则

参数	描述
生效层级	支持从实例、命名空间、OCI 制品仓库三个维度自定义镜像保留规则。本示例选择 OCI 制品仓库维度配置镜像版本保留策略，对存量、新增中不符合保留规则的镜像版本执行自动清理。
实例	选择保留规则生效的实例。本示例为 OCI 制品仓库 repo 所属的实例。
命名空间	选择保留规则生效的命名空间。本示例为 OCI 制品仓库 repo 所属的命名空间。
OCI 制品仓库	选择保留规则生效的 OCI 制品仓库，本示例为 repo。

参数	描述
保留规则	选择正则匹配，填写 ^tag.*，表示保留版本号以 tag 开头的镜像。
规则状态	支持选择启用或禁用版本保留规则。本示例开启。
触发规则	支持选择手动触发或定时触发版本保留规则。本示例选择定时触发。首次触发时间：填写最近一个周日的零时，本示例为 2023-11-26 00:00。触发频率：选择清理镜像的触发周期。本示例为七天 7 d。