镜像仓库 CR 提供体验版实例迁移功能，支持将体验版实例中的镜像、Helm chart 同步至同地域的小微版实例。

背景信息

体验版实例是免费的共享实例，在 产品使用限制 范围内，所有镜像仓库 CR 用户共享体验版实例。若当前您的体验版实例配额达到使用上限，或您对镜像和 Helm Chart 的推/拉并发数、下载速度等有较高要求，可使用实例同步功能，一键迁移体验版实例至其他规格实例，获取更好的 SLA 保障。

使用限制

• 手动触发和定时触发同步规则时，单规则同时正在同步的任务数需要小于等于 3，超过 3 个任务时新起的同步任务会排队等待，若等待任务超过 7 个时，后续新起的同步任务会失败。
• 每个账号最多支持同时启用 5 个同步规则。
• 规则删除后无法查看历史日志。
• 每个规则默认保留最近 1000 条同步日志。
• 实例同步规则被触发后，不支持终止本次同步任务。因此手动触发或创建定时/事件驱动触发的实例同步规则前，请确认参数配置是否准确。

前提条件

• 实例同步功能不支持同步命名空间中所关联的项目。如需关联请手动添加项目，操作方法参见 修改命名空间。
• 已创建小微版实例。详细操作，请参见 创建小微版实例。
• 若需要同步至小微版实例中指定命名空间，则确保已创建对应命名空间，详细操作参见 创建命名空间。
• 请确保体验版实例和目标小微版实例均处于 运行中 状态。

步骤一：配置同步规则

1. 登录 镜像仓库控制台。

2. 在左侧导航栏选择 实例同步，单击 创建实例同步规则。

3. 在 创建实例同步规则 页面，根据要求填写参数信息。
   

   参数	说明
   实例同步类型
   同步类型	选择 体验版迁移，将体验版实例中的镜像，迁移到其他规格的实例。
   基本信息
   名称	自定义同步规则名称。同一个账号下名称必须唯一。
   描述	填写对该规则的描述信息。可以为空，字数限制 200 字符以内。
   源实例配置
   实例	填写镜像仓库体验版实例名称。
   命名空间	体验版实例下需要同步的命名空间名称。支持多选、全选。
   仓库	需要同步的 OCI 制品仓库名称。 全部：同步指定命名空间下的全部 OCI 制品仓库。 正则匹配：通过输入正则规则，匹配需要同步的 OCI 制品仓库。配置详情，请参见本文下方 正则匹配示例。
   版本 Tag	需要同步的 OCI 制品版本。 全部：同步指定仓库下的全部 OCI 制品版本。 正则匹配：通过输入正则规则，匹配需要迁移的 OCI 制品版本。配置详情，请参见本文下方 正则匹配示例。
   目标实例配置
   实例名	选择需要同步的目标小微版实例，体验版实例将同步到该小微版实例。
   命名空间	填写目标小微版实例下的命名空间名称。 说明 若不填写，则默认同步至目标小微版实例下与体验版实例命名空间相同名称的命名空间。若未找到相同名称的命名空间，则创建同名的命名空间。
   同步规则
   镜像覆盖	勾选后启用。启用后表示若目标小微版实例中存在与体验版实例下镜像同名的镜像，则源实例镜像会覆盖目标实例的已有同名镜像。
   规则状态	勾选后启用该规则，并可选择设置以下触发条件： 事件驱动触发：设置后有符合规则的事件产生时，自动触发同步。即如果您向体验版实例符合同步规则的 OCI 制品仓库推送了符合规则的制品，则会自动触发一次同步，且只同步您新推送的制品。 您也可以通过配置 立即触发 为 是，在创建实例同步规则成功后，立即触发规则匹配，进行一次同步操作。 定时触发：设置后固定间隔时间触发一次同步，首次同步时间视设置决定。 首次触发时间：注意最早只能设置到当前时间。 触发频率：设置间隔时间。默认每 24 小时触发一次。可选范围为 1~720 小时。 手动触发：若选择手动触发，该规则不会被自动触发，需要您手动执行同步操作。
   自动清理	是否清理源实例中已同步的镜像： 勾选（默认）：体验版实例中的镜像，成功迁移到小微版实例后，从体验版实例中清理该镜像。 不勾选：成功迁移体验版实例中的镜像到小微版实例后，保留体验版实例中的镜像。 说明 建议您保持默认选项，在迁移成功后清理体验版实例中的镜像，释放资源。避免后续使用超过产品使用限制，影响体验。

步骤二：执行同步规则

支持如下三种触发方式：

• 若您在配置同步规则时选择 事件驱动触发，则有符合规则的事件发生时，系统自动触发同步；若选择 事件驱动触发 的同时，配置 立即触发 为 是，则在创建实例同步规则成功后，立即触发规则匹配。

  说明

  事件驱动出发的同步规则，也可以手动触发。

• 若您在配置同步规则时选择 定时触发，则系统会定时自动触发一次同步。

  说明

  定时触发的同步规则，也可以手动触发。

• 若您选择 手动触发，请参考以下步骤：
  1. 在 镜像仓库控制台的左侧导航栏选择 实例同步。
  2. 在 实例同步 页面，找到需要触发的规则，单击对应 操作 列的 触发。
     
  3. 在系统弹出的提示框中确认规则信息，单击 确定，触发同步操作。

步骤三：查看同步日志

1. 在 镜像仓库控制台 左侧导航栏选择 实例同步。

2. 在 实例同步 页面，找到目标规则，单击规则名称。

3. 在规则详情页面，单击 同步日志 页签，查看对应规则的所有同步日志。

   参数	说明
   任务 ID	实例内唯一的同步任务 ID。
   同步状态	任务完成状态，同步中、成功、失败。 说明 若同步状态为 成功，说明同步任务正常触发，且至少成功同步一个镜像版本。 若同步状态为 失败，表明任务触发失败。可能原因如下： 体验版实例状态不是 运行中 目标小微版实例状态不是 运行中
   任务耗时	完成全部同步任务消耗的时间。
   成功比例	（成功的 tag 数÷总 tag 数）×100％
   同步仓库数	当前任务需要同步的 OCI 制品仓库数量。
   触发时间	同步任务的触发时间。

4. 单击任务 ID，可查看该同步任务的详情。展示本次同步任务源实例下的[namespace]/[repo]:tag、目标实例下的[namespace]/[repo]:tag、以及同步状态。
   同步状态为 成功 表明源实例的制品成功同步到目标实例；同步状态为 失败 表明源实例的制品未能同步到目标实例。
   

正则匹配示例