Todos los productos
Search
Centro de documentos

Platform For AI:Imágenes personalizadas

Última actualización: Sep 11, 2026

Las imágenes personalizadas le permiten importar imágenes existentes o compilar nuevas directamente en PAI. De este modo, se admiten los flujos de trabajo de desarrollo y entrenamiento.

Descripción general

Existen dos formas de agregar imágenes personalizadas:

  • Importar una imagen existente: compile la imagen de forma local o en un servidor en la nube y envíela a Alibaba Cloud Container Registry (ACR). Después, regístrela como imagen personalizada de PAI al introducir los detalles de la imagen de ACR en la PAI console.

  • Compilar una nueva imagen: introduzca los detalles de la imagen de ACR, la configuración de ejecución y la configuración de compilación en la PAI console. Una vez que finaliza la compilación, la imagen se envía automáticamente a ACR y se registra como imagen personalizada de PAI.

Permisos

  • Cuenta de Alibaba Cloud (cuenta principal): cuenta con todos los permisos. No se requiere ninguna autorización adicional.

  • Usuario de RAM (subcuenta): debe agregarse al espacio de trabajo como miembro y asignársele un rol. Para más información, consulte Manage workspaces - Members and roles.

Registrar una imagen: importar una imagen existente

Vaya a AI Asset Management > Images y seleccione un espacio de trabajo. En la pestaña Custom Image, haga clic en Register image, seleccione Import existing image y registre una imagen de Alibaba Cloud Container Registry (ACR) como imagen personalizada de PAI.

Parámetros principales:

Parámetro

Descripción

Tipo de imagen

  • Imagen de Personal Edition: ofrece servicios básicos de registro de contenedores para desarrolladores individuales. Las imágenes de ACR de Personal Edition pueden tener límites de velocidad. Se recomiendan las imágenes de ACR de Enterprise Edition. Para más información, consulte Announcement about image upload and download restrictions of Container Registry Personal Edition.

  • Imagen de Enterprise Edition: aloja y distribuye artefactos compatibles con OCI (Open Container Initiative), como imágenes de contenedor, gráficos de Helm y Operators, para clientes empresariales.

Instancia de Enterprise Edition / namespace de imagen / repositorio de imagen / etiqueta de imagen / dominio personalizado

Seleccione una instancia de Enterprise Edition, un namespace, un repositorio, una etiqueta de imagen y un dominio personalizado existentes, o bien vaya a la consola de Container Registry para crearlos.

Nota
  • La instancia de Enterprise Edition y el dominio personalizado son obligatorios únicamente cuando Tipo de imagen es Image (Container Registry Enterprise Edition).

  • Si aparece un error de permiso, asigne la directiva AliyunContainerRegistryReadOnlyAccess al usuario de RAM. Para más información, consulte Manage RAM user permissions.

Visibilidad

  • Visible solo para el creador: la imagen registrada solo es visible para quien la creó y para los administradores de este espacio de trabajo.

  • Visible para los miembros del espacio de trabajo: la imagen registrada es visible para todos los miembros de este espacio de trabajo.

Tipo de chip

Seleccione CPU, GPU o PPU según el entorno de destino donde se ejecutará la imagen.

Registrar una imagen: compilar una nueva imagen

Vaya a AI Asset Management > Images y seleccione un espacio de trabajo. En la pestaña Custom Image, haga clic en Register image y seleccione Build new image. Cuando termina la compilación, la imagen se envía automáticamente a ACR y se registra como imagen personalizada de PAI.

Parámetros principales:

Parámetro

Descripción

Información básica

Tipo de imagen

Solo se pueden compilar imágenes de Enterprise Edition. Para más información, consulte What is Container Registry?.

Instancia de Enterprise Edition / namespace de imagen / repositorio de imagen / dominio personalizado

Seleccione una instancia de Enterprise Edition, un namespace, un repositorio y un dominio personalizado existentes, o bien vaya a la consola de Container Registry para crearlos.

Nota

Si aparece un error de permiso, asigne la directiva AliyunContainerRegistryReadOnlyAccess al usuario de RAM. Para más información, consulte Manage RAM user permissions.

Visibilidad

  • Visible solo para el creador: la imagen registrada solo es visible para quien la creó y para los administradores de este espacio de trabajo.

  • Visible para los miembros del espacio de trabajo: la imagen registrada es visible para todos los miembros de este espacio de trabajo.

Tipo de chip

Seleccione CPU, GPU o PPU según el entorno de destino donde se ejecutará la imagen.

Configuración de ejecución

Recursos de ejecución

Seleccione los recursos de cómputo para el trabajo de compilación según los requisitos de las dependencias o las instrucciones del Dockerfile en Configuración de compilación. Por ejemplo, si el Dockerfile incluye pasos de compilación, seleccione una asignación de recursos mayor.

VPC / security group

Seleccione la VPC vinculada a la instancia de Enterprise Edition.

Nota

Si el trabajo de compilación necesita acceder a internet (por ejemplo, para extraer imágenes base de terceros o instalar las dependencias especificadas en Configuración de compilación), cree una puerta de enlace NAT pública para la VPC, vincule una dirección IP elástica (EIP) y configure reglas SNAT. Para más información, consulte Improve internet access with a private gateway.

Configuración de compilación

Método de compilación

  • Compilar desde una imagen existente: admite imágenes oficiales, imágenes personalizadas y direcciones de imágenes de terceros (los registros privados requieren un nombre de usuario y una contraseña). Instale dependencias mediante pip2, pip3, yum o apt.

  • Compilar desde un Dockerfile: permite editar instrucciones con estilo Dockerfile. Para conocer los detalles de sintaxis, consulte la referencia de Dockerfile.

Consultar los trabajos de compilación de imágenes

  1. En la pestaña Custom Image, haga clic en View Task para consultar la lista de trabajos de compilación de imágenes.

  2. Haga clic en Details en la columna Actions para consultar los detalles del trabajo de compilación de la imagen.

  3. En la sección Runtime settings, haga clic en View Logs y View monitoring para revisar los registros y los datos de monitoreo del trabajo de DLC correspondiente.

Consultar imágenes personalizadas

Una vez completado el registro, vaya a la pestaña Custom Image para consultar las direcciones de la imagen registrada. Utilice estas imágenes en sus trabajos de entrenamiento.

En la columna Image address de la lista de imágenes, la dirección VPC de cada imagen se muestra con el formato <registry-name>-vpc.<region>.cr.aliyuncs.com/<namespace>/<image>:<tag>. Use esta dirección para hacer referencia a la imagen personalizada en los trabajos de entrenamiento.

Preguntas frecuentes

P: Al compilar una imagen con un Dockerfile, los registros muestran dial tcp xxx:443: i/o timeout. ¿Cómo lo soluciono?

Este error indica que el trabajo de compilación no puede comunicarse con el registro que aloja la imagen base:

  1. Compruebe si la dirección de imagen en la instrucción FROM o en el campo Based on existing image utiliza un dominio público. Si es así, reemplácelo por el dominio VPC correspondiente (formato de dominio público: <registry>.cn-xxx.cr.aliyuncs.com; formato de dominio VPC: <registry>-vpc.cn-xxx.cr.aliyuncs.com).

  2. Verifique que la VPC seleccionada en VPC / security group esté vinculada en la instancia de Enterprise Edition, dentro de control de acceso > VPC.

  3. Si el tiempo de espera sigue agotándose, compruebe que las reglas del security group permitan el tráfico saliente del trabajo de compilación hacia el endpoint VPC de ACR.

Temas relacionados