使用导入或构建方式注册自定义镜像-人工智能平台 PAI-阿里云-人工智能平台 PAI(PAI)-阿里云帮助中心

自定义镜像支持导入已有镜像或在平台上构建新镜像，满足不同的开发和训练需求。

功能简介

自定义镜像功能支持两种方式添加镜像：

导入已有镜像：先在本地或云服务器上构建镜像并推送至阿里云容器镜像服务（ACR），然后在 PAI 控制台填写 ACR 镜像信息，即可注册为 PAI 自定义镜像。
构建新镜像：在 PAI 控制台填写 ACR 镜像信息、运行信息和构建配置。构建完成后，镜像自动推送至 ACR 并注册为 PAI 自定义镜像。全程无需离开 PAI 平台。

操作权限

阿里云账号（主账号）：拥有所有操作权限，无需额外授权。
RAM 用户（子账号）：需要添加为工作空间成员并配置角色权限，详情参见管理工作空间-成员及角色配置。

注册镜像：导入已有镜像

前往AI 资产管理-镜像，选择工作空间后进入镜像管理页面。在自定义镜像页签下单击注册镜像，选择导入已有镜像，将阿里云容器镜像服务（ACR）中已有的镜像注册为 PAI 自定义镜像。

关键参数说明：

参数	说明
镜像类型	个人版镜像：面向个人开发者，提供基础容器镜像服务。个人版 ACR 镜像可能限速，建议使用企业版 ACR 镜像，详情参见容器镜像服务ACR个人版上传下载使用限制公告。企业版镜像：面向企业客户，提供容器镜像、Helm Chart、Operator 等符合 OCI 规范制品的安全托管及高效分发服务。
企业版镜像实例/镜像命名空间/镜像仓库/镜像版本/自定义域名	选择已创建的企业版镜像实例、命名空间、仓库、版本以及自定义域名，或前往容器镜像控制台创建。说明仅当镜像类型为企业版镜像时，才需配置企业版镜像实例和自定义域名。如果提示没有权限，请为当前 RAM 用户授予 AliyunContainerRegistryReadOnlyAccess 权限，详情参见管理RAM用户的权限。
可见范围	仅创建者可见：注册的镜像仅在此工作空间中对创建者和管理员可见。工作空间内可见：注册的镜像在此工作空间中对所有人可见。
芯片类型	支持选择 CPU、GPU 和 PPU 类型，确保镜像在对应环境中正常运行。

注册镜像：构建新镜像

前往AI 资产管理-镜像，选择工作空间后进入镜像管理页面。在自定义镜像页签下单击注册镜像，选择构建新镜像。构建完成后，镜像自动推送至阿里云容器镜像服务（ACR）并注册为 PAI 自定义镜像。

关键参数说明：

参数	说明
基础信息
镜像类型	当前仅支持构建企业版镜像。更多信息参见什么是容器镜像服务ACR。
企业版镜像实例/镜像命名空间/镜像仓库/自定义域名	选择已有的企业版镜像实例、命名空间、仓库和自定义域名，或前往容器镜像控制台创建。说明如果提示没有权限，请为当前 RAM 用户授予 AliyunContainerRegistryReadOnlyAccess 权限，详情参见管理RAM用户的权限。
可见范围	仅创建者可见：注册的镜像仅在此工作空间中对创建者和管理员可见。工作空间内可见：注册的镜像在此工作空间中对所有人可见。
芯片类型	支持选择 CPU、GPU 和 PPU 类型，确保镜像在对应环境中正常运行。
运行信息
运行资源	选择构建任务的运行资源。建议根据构建配置中的依赖项或 Dockerfile 指令的资源需求选择。例如，Dockerfile 中包含编译指令时，资源需求较高。
专有网络配置/安全组	选择企业版镜像实例所绑定的专有网络 VPC。说明如果镜像构建任务需要访问公网（如构建配置中的第三方镜像地址、安装依赖项等），需要为 VPC 创建公网 NAT 网关、绑定弹性 IP（EIP）并配置 SNAT，详情参见通过专有网关提升公网访问速率。
构建配置
构建方式	基于现有镜像：支持通过官方镜像、自定义镜像和第三方镜像地址（私有镜像仓库需输入账号和密码）构建，同时支持通过 pip2、pip3、yum 和 apt 安装依赖项。基于 Dockerfile：支持 Dockerfile 样式的指令编辑，详细语法参见Dockerfile reference。

查看镜像构建任务

在自定义镜像页签下单击查看任务，查看镜像构建任务列表。
单击操作列的详情，查看镜像构建任务详情。
单击运行信息区域的查看日志和查看监控，可查看对应 DLC 任务的日志和监控信息。

查看自定义镜像

镜像注册完成后，在自定义镜像页签下查看已注册的镜像地址，后续可在训练中使用该自定义镜像。

在镜像列表的镜像地址列中，可获取该镜像的 VPC 地址（格式如<registry-name>-vpc.<region>.cr.aliyuncs.com/<namespace>/<image>:<tag>），用于后续训练任务中引用该自定义镜像。