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

功能简介

PAI-AI资产管理中的自定义镜像功能允许您根据自身需求添加镜像。您可以选择导入已有镜像或构建新镜像：

导入已有镜像：您需要在本地或云服务器上先行构建镜像，并将其推送至阿里云容器镜像服务（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。

查看镜像构建任务

在自定义镜像页签下单击查看任务，查看镜像构建任务详情。

镜像构建任务页面展示任务列表，包含名称/ID、镜像名称、状态、创建时间、结束时间、执行时长和操作列。单击任务操作列的详情，右侧弹出镜像构建任务详情面板，包含三个区域：基础信息（镜像名称、镜像地址、镜像类型、镜像命名空间、镜像仓库、自定义域名、镜像版本、可见范围）、运行信息（任务名称、任务ID、运行资源、专有网络ID、安全组ID、日志与监控）和构建配置（构建方式、基础镜像、Dockerfile内容）。

单击任务详情页的查看日志和查看监控，您可以查看对应DLC任务的日志和监控信息：

任务详情页顶部显示任务进度条（依次为任务创建、环境准备、任务运行和任务成功四个阶段及各阶段耗时），左侧面板展示任务名称、执行时长、创建时间、结束时间等基本信息以及实例列表和状态，右侧日志区域展示用户日志内容，包括镜像构建与推送的详细过程及可能出现的错误与重试信息。

查看自定义镜像

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

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