导入外部仓库镜像

如果业务镜像已存放在外部仓库，可以先接入该仓库，再创建 Pull 规则，将匹配的镜像导入目标地域的项目。导入前先确定外部镜像的仓库路径、标签范围及目标项目，避免将不需要的版本一起导入。 支持导入以下四种类型的镜像仓库中的镜像：

• Docker Registry
• Docker Hub
• Google GCR
• Quay

​

操作前确认

• 已在目标地域准备接收镜像的项目。
• 已取得外部仓库的访问地址。如果仓库需要认证，已取得相应凭证。

​

接入外部仓库

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

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

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

​

创建同步规则

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

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

   源仓库（Source Registry）：

   配置项	说明
   Registry Endpoint	选择已接入的外部仓库端点。若没有可选端点，请先完成外部仓库接入。
   命名空间	填写或选择外部仓库中的源项目。
   仓库	填写或选择需要导入的镜像仓库。
   Tag (Regex)	填写需要导入的标签匹配条件。** 表示匹配全部标签；1.0* 表示匹配以 1.0 开头的标签。建议只匹配业务需要导入的版本范围。

   目标仓库（Destination Registry）：

   配置项	说明
   Region	选择接收镜像的目标地域。
   Namespace	填写或选择目标项目。导入完成后，镜像会写入该项目下。

   同步规则：

   配置项	说明
   Override Mode	启用后，目标项目中存在同名资源时会覆盖目标端资源。启用前先确认目标端已有版本是否仍需保留。
   Enable Rule	启用后，规则创建完成即生效。未启用时，规则会保存但不会开始同步。
   Trigger Mode	选择触发方式。 事件驱动：源镜像推送后触发同步。 定时：按 Cron 表达式周期导入。 手动：创建规则后由用户手动触发导入。

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

​

确认导入结果

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

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

​

相关文档

如果需要将当前地域的镜像分发到其他仓库，请参见同步镜像到其他地域或仓库。