同步镜像到其他地域或仓库

如果业务镜像已存放在 GPU 云服务的某个地域，可以创建 Push 规则，将匹配的镜像同步到其他地域的项目或已接入的外部仓库。同步前先确定源镜像的仓库路径、标签范围及目标项目，避免将不需要的版本一起同步。

​

操作前确认

• 已在源地域准备需要同步的镜像。
• 同步到外部仓库时，已取得外部仓库的访问地址。如果仓库需要认证，已取得相应凭证。

​

接入外部仓库（可选）

如果目标是 GPU 云服务其他地域，可跳过此节。只有同步到外部仓库时，才需要先添加外部仓库端点。

1. 登录 GPU 云服务控制台。
2. 进入 存储 > 镜像仓库 页面，选择源镜像所在地域。
3. 打开 复制 页签。
4. 单击展开 Registry Endpoints 区域，然后单击 添加端点。
5. 填写外部仓库连接信息。

   配置项	说明
   类型	选择外部仓库类型。
   名称	设置端点名称，用于在复制规则中识别该外部仓库。建议使用能体现仓库来源或用途的名称。
   URL	填写外部仓库的公开访问地址，例如 https://example.com。
   用户名	外部仓库需要认证时填写。公开仓库可不填。
   密码	外部仓库需要认证时填写。公开仓库可不填。

6. 单击 确认。 提交时会校验 URL 和凭证。若端点不可用，先检查外部仓库地址、网络可达性、用户名和密码，再创建同步规则。GPU 云服务地域之间同步镜像时，不需要添加外部仓库端点。

​

创建同步规则

1. 在 复制 页签下，单击 新建复制规则。
2. 在 Create Sync Rule 页面配置同步规则。 基本信息：

   配置项	说明
   Sync Type	选择 Push Mode，表示从当前地域向其他地域或外部仓库同步镜像。
   Rule Name	填写规则名称。建议使用能体现源项目、目标位置或同步范围的名称，便于在规则列表中识别。
   Description	按需填写规则说明，例如同步用途、维护人或适用业务。

   源仓库（Source Registry）：

   配置项	说明
   Region	选择源镜像所在地域。
   命名空间	选择源镜像所属项目。
   仓库	选择需要同步的镜像仓库。
   Tag (Regex)	填写需要同步的标签匹配条件。** 表示匹配全部标签；1.0* 表示匹配以 1.0 开头的标签。建议只匹配业务需要同步的版本范围。

   目标仓库（Destination Registry）：

   配置项	说明
   Type	选择目标仓库类型。Local 表示同步到 GPU 云服务其他地域；Remote 表示同步到已接入的外部仓库。
   Registry Endpoint	选择 Remote 时配置，选择已接入的外部仓库端点。若没有可选端点，请先完成外部仓库接入。
   Regions	选择 Local 时配置，选择接收镜像的目标地域。
   Namespace	填写或选择目标项目。同步完成后，镜像会写入该项目下。

   同步规则：

   配置项	说明
   Override Mode	启用后，目标项目中存在同名资源时会覆盖目标端资源。启用前先确认目标端已有版本是否仍需保留。
   Enable Rule	启用后，规则创建完成即生效。未启用时，规则会保存但不会开始同步。
   Trigger Mode	选择触发方式。 事件驱动：源镜像推送后触发同步。 定时：按 Cron 表达式周期同步。 手动：创建规则后由用户手动触发同步。
   Cron	选择 定时 时填写。Cron 表达式使用 UTC 时间，按页面校验要求，第 1 项必须为 0，第 2 项不能为 *。例如 0 0 8 * * 1-5 表示每周一至周五 UTC 08:00 执行。

3. 提交规则，在规则列表中确认新规则已出现。使用手动触发方式时，还需要对该规则执行一次同步。

​

确认同步结果

在 复制 页签查看对应规则的执行记录。

• 如有失败任务，查看该任务的日志，重点检查源镜像路径、标签匹配、目标项目和外部仓库连接。
• 执行成功后，切换到目标地域或目标仓库，确认镜像已进入预期项目。

​

相关文档

如果需要将外部仓库中的镜像导入当前地域的镜像仓库，请参见导入外部仓库镜像。