> ## 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.

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

> 创建 Push 复制规则，把指定镜像同步到目标地域或外部镜像仓库。

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

## 操作前确认

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

## 接入外部仓库（可选）

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

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** | 选择 **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** | 选择触发方式。<ul><li>**事件驱动**：源镜像推送后触发同步。</li><li>**定时**：按 Cron 表达式周期同步。</li><li>**手动**：创建规则后由用户手动触发同步。</li></ul> |
   | **Cron** | 选择 **定时** 时填写。Cron 表达式使用 UTC 时间，按页面校验要求，第 1 项必须为 `0`，第 2 项不能为 `*`。例如 `0 0 8 * * 1-5` 表示每周一至周五 UTC 08:00 执行。 |

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

## 确认同步结果

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

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

## 相关文档

如果需要将外部仓库中的镜像导入当前地域的镜像仓库，请参见[导入外部仓库镜像](https://docs.siflow.cn/gpu-cloud/registry/import-external-container-images.md)。


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