All Products
Search
Document Center

Platform For AI:Custom images

Last Updated:Aug 18, 2025

AI Asset Management of Platform for AI (PAI) provides the custom image feature that allows you import existing images or build new images on the platform. This feature can meet various development and training requirements, improving efficiency and convenience.

Overview

The custom image feature of AI Asset Management allows you to add images based on your business requirements. You can either import existing images or build new images.

  • Import existing images: You must build images on your on-premises machine or an ECS instance, push them to Alibaba Cloud Container Registry, and then enter the Container Registry image information in the PAI console. This way, the images can be registered as custom images of PAI. This method allows you to use existing images, but the process is relatively complex.

  • Build new images: You only need to enter the Container Registry image information and configure the job running and image building settings in the PAI console. After the image building job is complete, the image is pushed to Container Registry and registered as a custom image of PAI. This method simplifies the operation process, meeting your needs for one-stop use of custom images and significantly improving efficiency and convenience.

Permission requirements

  • Alibaba Cloud account: has the permissions to perform all operations.

  • RAM user: must be added as a workspace member and granted the role permissions. For more information, see Configure Member and Role.

Register an image: import an existing image

Go to Workspaces page, find the workspace that you want to manage, and then click its name. In the left-side navigation pane of the Workspace Details page, choose AI Asset Management > Images. On the Custom Image tab, click Register Image. Then, select Import Existing Image to register your existing image from Container Registry as a custom image of PAI.

image

The following table describes the key parameters.

Parameter

Description

Image Type

  • Personal Edition Image (Container Registry): provides basic services for individual developers. An image upload and download restriction is imposed on Container Registry Personal Edition. We recommend that you use Container Registry Enterprise Edition. For more information, see Announcement about image upload and download restrictions of Container Registry Personal Edition.

  • Enterprise Edition Image (Container Registry): allows enterprises to manage and distribute Open Container Initiative (OCI) artifacts, such as container images, Helm charts, and Kubernetes operators, in a secure and efficient manner.

Enterprise Edition Instance (Container Registry)/Image Namespace/Image Repository/Image Version/Custom Domain Name

Select an Enterprise Edition instance, namespace, repository, image version, and custom domain name, or go to the Container Registry console to create them.

Note

Visibility

  • Visible to Me: The registered image is visible only to you and the administrator of the workspace.

  • Visible to Current Workspace: The registered image is visible to all members in the workspace.

Chip Type

Support the CPU and GPU types to ensure that the registered image can run properly in specific environments.

Register an image: build an image

Go to Workspaces page, find the workspace that you want to manage, and then click its name. In the left-side navigation pane of the Workspace Details page, choose AI Asset Management > Images. On the Custom Image tab, click Register Image. Then, select Build New Image. After the image is built, the image is pushed to Container Registry and registered as a custom image of PAI.

image

The following table describes the key parameters.

Parameter

Description

Basic Information

Image Type

Only Enterprise Edition Image (Container Registry) is supported. For more information about Enterprise Edition and Personal Edition images, see What is Container Registry?

Enterprise Edition Instance (Container Registry)/Image Namespace/Image Repository/Custom Domain Name

Select an Enterprise Edition instance, namespace, repository, image version, and custom domain name, or go to the Container Registry console to create them.

Note

If the message indicating that you do not have permissions appears, attach the AliyunContainerRegistryReadOnlyAccess policy to your RAM user.

Visibility

  • Visible to Me: The registered image is visible only to you and the administrator of the workspace.

  • Visible to Current Workspace: The registered image is visible to all members in the workspace.

Chip Type

Support the CPU and GPU types to ensure that the registered image can run properly in specific environments.

Running Information

Resources

Select the resources for building the image. We recommend that you choose appropriate resources based on the dependencies in Build Configurations or Dockerfile instructions. For example, if the Dockerfile contains program compilation instructions, the requirement for resources is relatively high.

VPC Configuration/Security Group

Select the virtual private cloud (VPC) in which the Enterprise Edition instance resides.

Note

If the image building job requires Internet access, such as the third-party image address and dependency installation in Build Configurations, you must create an Internet NAT gateway, associate an elastic IP address (EIP) with the instance, and configure SNAT. For more information, see Improve Internet access rate by using a private gateway.

Build Configurations

Build Method

  • Based on Existing Image: Support image building by using an official image, custom image, or third-party image address. If you need to grant permissions on a private image repository, you must enter the username and password. In addition, you can install dependencies by using pip2, pip3, yum, or apt.

  • Based on Dockerfile: Support Dockerfile-style instruction editing. For information about the syntax, see Dockerfile reference.

View an image building job

On the Custom Image tab, click View Jobs. On the Image Building Job page, find the image building job that you want to manage and click Details in the Actions column.

image

In the Image Building Job Details panel, click View Logs and View Monitoring to view the logs and monitoring information.

image

View a custom image

After an image is registered, you can view the registered custom image on the Custom Image tab. Then, you can use the custom image for training later.

image

References