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

# 镜像管理概述

> 了解人工智能平台中的内置镜像、自定义镜像、多集群副本和镜像使用统计。

镜像管理用于维护开发环境、训练任务和推理服务使用的容器镜像。镜像封装了程序运行所需的操作系统、框架、Python 版本、CUDA 版本、依赖库和启动工具，决定负载启动后的运行环境。

平台镜像分为内置镜像和自定义镜像。内置镜像由平台维护，可直接选择使用；自定义镜像由您基于已有镜像、Dockerfile、第三方镜像或已有仓库镜像构建和注册，用于满足自有依赖、框架版本或业务代码环境要求。

## 适用场景

* 在开发环境、训练任务或推理服务中选择合适的运行环境。
* 基于平台镜像安装自有依赖，构建团队可复用的自定义镜像。
* 将外部镜像同步或注册到平台镜像仓库中使用。
* 查看镜像在训练任务、开发环境和推理服务中的使用情况。

## 镜像类型

| 类型    | 说明                                                            | 适合场景                          |
| ----- | ------------------------------------------------------------- | ----------------------------- |
| 内置镜像  | 平台维护的预置镜像，通常包含 Ray、PyTorch、Megatron、Llama Factory 等常用训练或推理环境。 | 快速创建开发环境、训练任务或推理服务，不需要额外安装依赖。 |
| 自定义镜像 | 您构建、导入或注册的镜像，可包含自有依赖、代码、工具和运行时配置。                             | 内置镜像不满足框架版本、依赖库或业务环境要求。       |

## 镜像和集群关系

镜像按区域和集群组织。同一镜像在不同集群可能有独立副本和不同镜像 URL。创建开发环境、训练任务或推理服务时，请确认目标区域和集群中存在可用镜像。

平台会为租户提供镜像仓库项目，用于存储内置镜像副本、自定义镜像和导入镜像。镜像仓库存储容量有限，构建或导入镜像前建议关注当前仓库存储用量。

自定义镜像可通过镜像仓库同步策略分发到多个集群。同步完成后，目标集群中的负载才能直接选择和拉取该镜像。

## 使用流程

1. 选择内置镜像，或创建自定义镜像。
2. 如需跨集群使用，配置或确认镜像同步策略。
3. 等待镜像构建或同步完成。
4. 在开发环境、训练任务或推理服务中选择镜像。
5. 根据使用统计和仓库事件，清理不再使用的镜像或排查镜像拉取问题。

## 相关文档

* [使用内置镜像](./use-built-in-images)
* [构建自定义镜像](./build-custom-images)
* [管理自定义镜像](./manage-custom-images)