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

# 同步镜像到其他集群

> 在人工智能平台中配置镜像仓库同步策略，将自定义镜像分发到其他集群，并查看同步执行信息和仓库事件。

不同集群的计算、存储资源和镜像仓库相互独立。若需要在多个集群中使用同一自定义镜像，可以配置镜像仓库同步策略。镜像同步完成后，目标集群中的开发环境、训练任务或推理服务才能选择该镜像。

## 创建同步策略

如果创建镜像时页面提示未配置同步规则，可按需选择是否同步至其他集群。同步规则创建后，后续构建成功的镜像会按规则同步到目标集群。具体可同步的区域和集群以当前平台配置为准。

1. 进入 **镜像管理 > 自定义镜像**。
2. 打开 **镜像仓库同步策略** 页签，单击 **新建策略**。
3. 填写策略配置。

| 配置项         | 说明                                                                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| 同步类型        | 选择 **推送模式** 或 **拉取模式**。**推送模式** 用于同步到其他地域或外部 Registry；**拉取模式** 用于从外部 Registry 拉取镜像。                                                  |
| 策略名称、描述     | 填写策略名称，并按需补充描述，便于后续识别同步用途。                                                                                                           |
| 源 Registry  | 配置源端镜像仓库信息，包括 **区域**、**命名空间**、**Repository** 和 **Tag（正则）**。**Tag（正则）** 用于匹配需要同步的镜像标签，例如 `1.0*` 匹配以 `1.0` 开头的 tag。                    |
| 目标 Registry | 配置目标端镜像仓库信息。目标类型可选择 **Local** 或 **Remote**；选择 **Local** 时，填写 **Regions** 和 **命名空间**。                                                 |
| 覆盖模式        | 目标端存在同名资源时，配置是否覆盖。                                                                                                                   |
| 启用策略        | 启用后，平台会按触发规则自动同步镜像。                                                                                                                  |
| 触发类型        | 选择同步策略的触发方式：<ul><li>**事件驱动**：源仓库有镜像推送后自动触发同步。</li><li>**定时**：配置 Cron 表达式，按计划触发同步。</li><li>**手动**：策略新建完成后，在策略列表中单击对应按钮触发同步。</li></ul> |
| 同步删除远端资源    | 按需开启。开启后，同步时可能删除远端关联镜像，操作前请确认删除影响。                                                                                                   |

4. 配置完成后，单击 **新建策略**。

## 查看同步结果

策略创建后，可在 **镜像仓库同步策略** 中查看规则详情和执行信息。镜像同步完成后，再到 **可用镜像列表** 或镜像详情中确认目标集群是否已有可用镜像 URL。

同步异常时，可结合以下信息排查：

* **同步策略详情**：确认源 Registry、目标 Registry、Tag 匹配规则和触发类型是否符合预期。
* **执行信息**：查看同步任务是否已触发、是否成功完成。
* **镜像仓库事件**：查看由 Webhook 触发的镜像仓库事件记录，判断事件是否已产生或投递。

## 停用或删除同步策略

同步策略不再需要自动执行时，可在策略列表中停用或删除：

* **停用**：停止策略后续自动触发，保留策略配置，适合临时暂停跨集群同步。
* **删除**：移除不再使用的同步策略。删除前，请确认后续不再需要按该规则同步镜像；删除策略不会自动删除已经同步到目标集群的镜像。

## 相关文档

* [管理自定义镜像](./manage-custom-images)