> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 导入外部仓库镜像

> 通过远程仓库和 Pull 复制规则，将外部镜像导入所选地域的镜像仓库。

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

支持导入以下四种类型的镜像仓库中的镜像：

* Docker Registry
* Docker Hub
* Google GCR
* Quay

## 操作前确认

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

## 接入外部仓库

1. 登录 [GPU 云服务控制台](https://console.siflow.cn/gpu-cloud/home)。

2. 进入 **存储 > 镜像仓库** 页面，选择目标地域。

3. 打开 **复制** 页签。

4. 单击展开 **Registry Endpoints** 区域，然后单击 **添加端点**。

   ![Registry Endpoints 区域](https://mintcdn.com/siflow/dUChFiiLy9KdHCra/gpu-cloud/registry/media/image-registry-endpoints.png?fit=max\&auto=format\&n=dUChFiiLy9KdHCra\&q=85\&s=fbe70f13aee77969baa79bf6fab485bf)

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** | 选择触发方式。<ul><li>**事件驱动**：源镜像推送后触发同步。</li><li>**定时**：按 Cron 表达式周期导入。</li><li>**手动**：创建规则后由用户手动触发导入。</li></ul> |

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

## 确认导入结果

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

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

## 相关文档

如果需要将当前地域的镜像分发到其他仓库，请参见[同步镜像到其他地域或仓库](https://docs.siflow.cn/gpu-cloud/registry/sync-container-images.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.