文档中心

镜像仓库

实例同步

实例间同步

镜像仓库 CR 对标准版实例提供实例同步功能，支持自定义创建同步规则，将指定源实例内的镜像及 Helm Chart 同步至另一个目标实例内的指定位置。

说明

本操作仅适用于标准实例，不适用于远端代理仓。

适用场景

本文涵盖以下两种实例同步场景：

同步场景	说明
同地域或跨地域同步	在同一火山引擎主账号下，将标准版实例中的镜像同步到同地域或跨地域的其他标准版实例。适用于多地域部署、容灾备份、就近拉取等场景。
向自定义仓库同步	将标准版实例中的镜像同步到火山引擎以外的外部仓库（如自建 Harbor、阿里云 ACR、华为云 SWR、腾讯云 TCR 等）。适用于混合云部署、跨云分发、多云容灾等场景。

前提条件

适用场景	条件
同地域或跨地域同步	源实例和目标实例均为标准版，且状态为运行中。创建实例的操作详情参见创建标准实例。
		源实例和目标实例属于同一火山引擎主账号。
		已购买目标标准版实例并创建命名空间。创建命名空间的操作详情参见创建命名空间。
		跨地域场景下，源实例和目标实例需分别开启公网访问。开启公网的操作详情参见开启公网访问。
向自定义仓库同步	源实例为标准版，且状态为运行中。创建实例的操作详情参见创建标准实例。
		支持同步的外部目标仓库类型：自建 Harbor、阿里云 ACR、华为云 SWR、腾讯云 TCR。
		自定义仓库支持通过公网连接。
		已获取外部目标仓库的服务地址、用户名、密码。
		已确认外部目标仓库中存在对应的命名空间（如果不存在同名命名空间则同步失败）。

操作步骤

步骤一：配置同步规则

登录镜像仓库控制台。

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

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

实例同步类型

参数
说明
同步类型
选择实例间同步，将标准版实例同步到本账号下其他标准版实例，或外部自定义仓库。

基本信息

参数
说明
名称
自定义同步规则名称。同一个账号下名称必须唯一。
描述
填写对该规则的描述信息。可以为空，字数限制 200 字符以内。

源实例

参数	说明
实例	选择需要同步的源标准版实例。
命名空间	选择源实例下需要同步的命名空间名称。
仓库	需要同步的 OCI 制品仓库名称。全部：同步指定命名空间下的全部 OCI 制品仓库。正则匹配：通过正则规则匹配需要同步的 OCI 制品仓库。常用的正则匹配示例参见正则匹配示例。
版本 Tag	需要同步的 OCI 制品版本。全部：同步指定仓库下的全部 OCI 制品版本。正则匹配：通过正则规则匹配需要同步的 OCI 制品版本。常用的正则匹配示例参见正则匹配示例。

目标实例

主账号内（同地域或跨地域同步）

自定义（向自定义仓库同步）

将镜像同步到本账号下同地域或跨地域的其他标准版实例。

参数	说明
同步类型	选择主账号内。
地域	注意跨地域场景下，源实例和目标实例均需要开启公网访问。开启公网的操作详情参见开启公网访问。选择目标标准版实例所在的地域。
实例名	选择目标标准版实例。
命名空间	选择目标实例下的命名空间。不填写则默认同步至与源实例同名的命名空间；若不存在同名命名空间，则自动创建。

同步规则

说明

事件驱动触发和定时触发的同步规则，均支持手动触发。

参数	说明
镜像覆盖	勾选后启用。启用后若目标端存在与源端同名的镜像，则源端镜像会覆盖目标端已有同名镜像。
规则状态	勾选后启用该规则，并可设置以下触发条件：事件驱动触发：设置后有符合规则的事件产生时，自动触发同步。即如果您向源实例符合同步规则的 OCI 制品仓库推送了符合规则的制品，则会自动触发一次同步，且只同步您新推送的制品。您也可以通过配置立即触发为是，在创建实例同步规则成功后，立即触发规则匹配，进行一次同步操作。定时触发：设置后固定间隔时间触发一次同步，首次同步时间视设置决定。首次触发时间：注意最早只能设置到当前时间。触发频率：设置间隔时间。默认每 24 小时触发一次。可选范围为 1~720 小时。手动触发：若选择手动触发，该规则不会被自动触发，需要您手动执行同步操作。

步骤二：执行同步规则

支持如下三种触发方式：

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

说明

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

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

说明

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

若您选择手动触发，请参考以下步骤：

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

在实例同步页面，找到需要触发的规则，单击对应操作列的触发。

在系统弹出的提示框中确认规则信息，单击确定，触发同步操作。

步骤三：查看同步日志

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

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

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

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

单击任务 ID，可查看该同步任务的详情。展示本次同步任务源实例下的[namespace]/[repo]:tag，目标实例下的[namespace]/[repo]:tag，及同步状态。

同步状态为成功表明源实例的制品成功同步到目标实例；同步状态为失败表明源实例的制品未能同步到目标实例。

最近更新时间：2026.06.25 20:40:55

这个页面对您有帮助吗？

有用

无用

参数	说明
名称	自定义同步规则名称。同一个账号下名称必须唯一。
描述	填写对该规则的描述信息。可以为空，字数限制 200 字符以内。

参数	说明
同步类型	选择自定义。
服务地址	以http(s)://开头的外部自定义仓库地址。例如http(s)://index.dockerhub.io。
忽略证书有效性	是否忽略证书的有效性。是：忽略外部仓库证书的有效性，直接同步。否：不忽略证书有效性，证书不在有效期内则无法同步。外部仓库证书必须为权威机构签发。
用户名	登录外部自定义仓库的用户名。
密码	登录外部自定义仓库的密码。
命名空间	注意若外部自定义仓库为阿里云 ACR，命名空间下的仓库（repo）名称请勿带 / 字符，否则会同步失败。输入外部自定义仓库下的目标命名空间名称。不填写则默认同步至与源实例同名的命名空间；如果不存在同名命名空间则同步失败。