用户在使用CCR的过程中，随着业务的快速迭代，将会产生大量的镜像版本。其中很多老旧的镜像版本随着时间推移不再被使用，这些多余的版本有存储成本，同时也会给镜像管理带来一定的负担。您可以使用版本保留功能进行定期清理。

注意事项

• 通过创建保留规则，执行规则时会将保留规则外的镜像版本自动删除。注：版本保留功能不会自动清理存储空间，如需清理存储空间请配置制品清理策略，详见：制品清理
• 版本保留规则执行后，被删除的镜像版本将无法拉取。为了避免镜像误删除，建议您针对关键镜像进行模拟执行，了解镜像清理范围以后再正式执行。
• 镜像仓库中可能存在不同镜像版本对应相同Artifact制品的情况，保留规则执行时如果一个镜像版本满足清理规则，则共用相同Artifact制品的镜像版本都会被删除。
• 保留规则执行期间，不建议您同时手动删除进行版本，可能会导致最终保留版本与预期不一致。

前提条件

• 已成功创建企业版实例。
• 实例中至少存在一个镜像仓库，具体信息请参见管理镜像仓库。

操作步骤

1. 登录百度智能云控制台，选择“产品服务 > 容器镜像服务 > CCR”。
2. 进入目标实例，点击“仓库管理”，选择“版本保留”。
3. 点击“创建规则”按钮，选择命名空间后，您可选择使用简易模式或高级模式创建保留规则。

简易模式

• 保留版本：默认为命名空间内全部仓库及版本。
• 保留策略：支持保留最新推送的n个版本、保留n天内推送的版本、保留最新拉取的n个版本、保留n天内被拉取过的版本，您可以按需选择。
• 执行周期：可选择手动执行、每天、每周或每月执行。每天为每日零点，每周默认为周一零点，每月为每月第一天零点清理镜像版本。

高级模式

• 仓库过滤和版本过滤：支持正则表达式匹配。
• 保留策略：支持保留最新推送的n个版本、保留n天内推送的版本、保留最新拉取的n个版本、保留n天内被拉取过的版本，您可以按需选择。
• 可设置最多15条保留规则，最终效果取多条规则的并集。
• 执行周期：可选择手动执行、每天、每周或每月执行。每天为每日零点，每周默认为周一零点，每月为每月第一天零点清理镜像版本。

4.创建成功后，在“版本保留”页面，您可查看已创建的保留规则，并可执行、编辑或删除现有规则。

版本保留配置参考

正则表达式

当通过高级模式配置版本保留规则，填写“仓库”和“版本”过滤规则时，其正则表达式支持的匹配规则：
* ：匹配所有不包含路径分隔符（/）的任意长字符串。
**：匹配所有的任意长字符串，包括路径分隔符（/）。
注意：
**必须作为一段完整的相对路径，如果使用 /ccr**，其作用将等同于 /ccr，仅能匹配以ccr为名称前缀的一级仓库。要想匹配ccr下的所有仓库，应使用 /ccr/**；要想匹配以ccr为名称前缀的所有仓库，则应使用 /ccr/**。
?：匹配除 ‘/’ 以外的任意单个字符。
{str1, str1, …}：同时匹配多个正则表达式。

典型场景

过滤类型	场景	正则表达式
仓库过滤规则	匹配当前命名空间内所有镜像仓库	** 或者不填
	匹配选定命名空间内以 ccr 为名称前缀的所有一级仓库	ccr*
	匹配选定命名空间内以 ccr1 和 ccr2 为名称前缀的所有一级仓库	{ccr1, ccr2}
	匹配选定命名空间内 ccr1 和 ccr2 目录下的所有仓库	{ccr1, ccr2}/**
	匹配选定命名空间内以 ccr1 和 ccr2 为名称前缀的所有仓库	{ccr1, ccr2}*/**
版本过滤规则	匹配选定仓库内所有 1.x 的版本Tag	1.?
	匹配选定仓库内所有以 dev1 和 dev2 为名称前缀的版本 Tag	{dev1, dev2}

FAQ

1.保留结果如何查看？
如下图示例： RETAIN：对应的镜像版本将会保留。
DEL：对应的镜像版本将会自动删除。
2.如何确认镜像清理操作不会误删重要镜像？
在执行镜像清理之前，建议进行模拟执行，以确认将要删除的镜像范围及清理时间，确保不会误删关键镜像