自定义镜像支持导入已有镜像或在平台上构建新镜像，满足不同的开发和训练需求。
功能简介
自定义镜像功能支持两种方式添加镜像：
-
导入已有镜像：先在本地或云服务器上构建镜像并推送至阿里云容器镜像服务（ACR），然后在 PAI 控制台填写 ACR 镜像信息，即可注册为 PAI 自定义镜像。
-
构建新镜像：在 PAI 控制台填写 ACR 镜像信息、运行信息和构建配置。构建完成后，镜像自动推送至 ACR 并注册为 PAI 自定义镜像。全程无需离开 PAI 平台。
操作权限
-
阿里云账号（主账号）：拥有所有操作权限，无需额外授权。
-
RAM 用户（子账号）：需要添加为工作空间成员并配置角色权限，详情参见管理工作空间-成员及角色配置。
注册镜像：导入已有镜像
前往AI 资产管理-镜像，选择工作空间后进入镜像管理页面。在自定义镜像页签下单击注册镜像，选择导入已有镜像，将阿里云容器镜像服务（ACR）中已有的镜像注册为 PAI 自定义镜像。
关键参数说明：
|
参数 |
说明 |
|
镜像类型 |
|
|
企业版镜像实例/镜像命名空间/镜像仓库/镜像版本/自定义域名 |
选择已创建的企业版镜像实例、命名空间、仓库、版本以及自定义域名，或前往容器镜像控制台创建。 说明
|
|
可见范围 |
|
|
芯片类型 |
支持选择 CPU、GPU 和 PPU 类型，确保镜像在对应环境中正常运行。 |
注册镜像：构建新镜像
前往AI 资产管理-镜像，选择工作空间后进入镜像管理页面。在自定义镜像页签下单击注册镜像，选择构建新镜像。构建完成后，镜像自动推送至阿里云容器镜像服务（ACR）并注册为 PAI 自定义镜像。
关键参数说明：
|
参数 |
说明 |
|
基础信息 |
|
|
镜像类型 |
当前仅支持构建企业版镜像。更多信息参见什么是容器镜像服务ACR。 |
|
企业版镜像实例/镜像命名空间/镜像仓库/自定义域名 |
选择已有的企业版镜像实例、命名空间、仓库和自定义域名，或前往容器镜像控制台创建。 说明
如果提示没有权限，请为当前 RAM 用户授予 AliyunContainerRegistryReadOnlyAccess 权限，详情参见管理RAM用户的权限。 |
|
可见范围 |
|
|
芯片类型 |
支持选择 CPU、GPU 和 PPU 类型，确保镜像在对应环境中正常运行。 |
|
运行信息 |
|
|
运行资源 |
选择构建任务的运行资源。建议根据构建配置中的依赖项或 Dockerfile 指令的资源需求选择。例如，Dockerfile 中包含编译指令时，资源需求较高。 |
|
专有网络配置/安全组 |
选择企业版镜像实例所绑定的专有网络 VPC。 说明
如果镜像构建任务需要访问公网（如构建配置中的第三方镜像地址、安装依赖项等），需要为 VPC 创建公网 NAT 网关、绑定弹性 IP（EIP）并配置 SNAT，详情参见通过专有网关提升公网访问速率。 |
|
构建配置 |
|
|
构建方式 |
|
查看镜像构建任务
在自定义镜像页签下单击查看任务，查看镜像构建任务详情。
镜像构建任务页面展示任务列表，包含名称/ID、镜像名称、状态、创建时间、结束时间、执行时长和操作列。单击操作列的详情，右侧弹出镜像构建任务详情面板，包含基础信息、运行信息和构建配置三个区域。
单击任务详情页的查看日志和查看监控，可查看对应 DLC 任务的日志和监控信息：
任务详情页顶部显示任务进度条（依次为任务创建、环境准备、任务运行和任务成功四个阶段及各阶段耗时），左侧面板展示任务名称、执行时长、创建时间、结束时间等基本信息以及实例列表和状态，右侧日志区域展示用户日志内容，包括镜像构建与推送的详细过程及可能出现的错误与重试信息。
查看自定义镜像
镜像注册完成后，在自定义镜像页签下查看已注册的镜像地址，后续可在训练中使用该自定义镜像。
在镜像列表的镜像地址列中，可获取该镜像的 VPC 地址（格式如<registry-name>-vpc.<region>.cr.aliyuncs.com/<namespace>/<image>:<tag>），用于后续训练任务中引用该自定义镜像。
相关文档
-
注册为 PAI 自定义镜像后，可在训练任务中使用，详情参见创建训练任务。