MaxCompute:Imágenes personalizadas

Paso 1: Instalar Docker

• Linux: Instale Docker siguiendo la documentación oficial de Docker.

• macOS o Windows:

  • Desarrolladores individuales: Puede utilizar Docker Desktop.

  • Usuarios empresariales sin licencia de Docker Desktop: Se recomienda utilizar la opción de código abierto Rancher Desktop.

Paso 2: Otorgar permisos

Otorgue a la cuenta o al usuario el permiso de lectura para roles de RAM, los **permisos operativos para ACR y los permisos operativos para imágenes personalizadas de MaxCompute**, tal como se describe en la siguiente tabla.

Paso 3: Compilar una imagen personalizada

Compile una imagen personalizada mediante un Dockerfile basado en una imagen base de MaxCompute.

• La URL de la imagen base CentOS de MaxCompute es registry.cn-zhangjiakou.aliyuncs.com/maxcompute_image/base_image:latest. Esta imagen base proporciona un entorno básico que incluye Python 3.7, Python 3.11, pip y yum.

• La dirección de la imagen base Ubuntu de MaxCompute es registry.cn-zhangjiakou.aliyuncs.com/maxcompute_image/ubuntu_20.04:latest.

1. Cree un Dockerfile basado en una imagen base de MaxCompute. Ejecute este comando:

   vim DockerFile

2. Agregue el siguiente contenido al Dockerfile:

   # Use the MaxCompute CentOS base image.
   FROM registry.cn-zhangjiakou.aliyuncs.com/maxcompute_image/base_image:latest
   
   # To use the Ubuntu image, replace the image address with registry.cn-zhangjiakou.aliyuncs.com/maxcompute_image/ubuntu_20.04:latest.
   
   # Install system dependencies.
   RUN yum install vi -y
   
   # Install third-party libraries.
   RUN /usr/ali/python3.7/bin/python3 -m pip install --no-cache-dir pandas

3. Compile la imagen desde el Dockerfile.

   sudo docker build -f DockerFile -t <image_name>:<tag> .

   Parámetros:

   • image_name: El nombre de la imagen personalizada.

   • tag: La versión de la imagen personalizada.

Paso 4: Enviar la imagen a ACR

1. Inicie sesión en la consola de Container Registry y seleccione una región en la esquina superior izquierda.

2. En el panel de navegación izquierdo, seleccione Instances.

3. En la página Instances, haga clic en Create ACR EE. Si ya creó una instancia, puede omitir este paso.

   Importante

   Solo puede cargar imágenes personalizadas en instancias Standard Edition o Premium Edition de ACR Enterprise Edition.

4. En la página Instances, busque la instancia de Enterprise Edition deseada y haga clic en Manage para abrir la página de descripción general de la instancia.

5. En el panel de navegación izquierdo, seleccione Repository > Repositories.

   En la página Repository > Repositories, haga clic en Create Repository. En el cuadro de diálogo Create Repository, introduzca la siguiente información y haga clic en Next.

   Parámetro	Obligatorio	Descripción
   Region	Sí	La región de la instancia actual se completa automáticamente.
   Namespace	Sí	Defina el namespace para el repositorio de imágenes. Esta configuración no se puede modificar posteriormente. Se recomienda crear un namespace que corresponda a una empresa, organización o usuario individual, como aliyun. No se recomienda crear un namespace que corresponda a un módulo o sistema, como tomcat o centos.
   Repository Name	Sí	El nombre debe tener entre 2 y 120 caracteres y puede contener letras minúsculas, números y los siguientes separadores: guiones bajos (_), guiones (-), puntos (.) y barras diagonales (/). El nombre no puede comenzar ni terminar con un separador.
   Repository Type	No	Public: Para extraer una imagen pública, debe iniciar sesión en la instancia Enterprise Edition. Si desea permitir extracciones anónimas, habilite la configuración de extracción anónima pública para la instancia. La extracción de una imagen privada de Enterprise Edition requiere iniciar sesión en una instancia Enterprise Edition con permisos de extracción. El valor predeterminado es privada.
   Tags	No	After selected, all tags other than the latest in the repository cannot be overwritten, ensuring the consistency of the container images.
   Accelerated Image	No	After selected, all images in the repository will automatically generate the accelerated images with "_accelerated" suffix Full Mode: Full mode provides a significant acceleration effect. The size of an accelerated image is approximately 130% the size of the original image. The system requires approximately 25 seconds to generate a 1 GB-sized accelerated image. If an accelerated image layer has been generated for an image layer, the system does not generate an accelerated image layer again for the image layer. Index-only Mode (Public Preview): Este modo proporciona alrededor del 70 % del efecto de aceleración del modo completo. La imagen acelerada representa aproximadamente el 3 % del tamaño de la imagen original. Se requieren unos 3 segundos para generar una imagen acelerada de 1 GB. Las capas que ya están indexadas no se vuelven a indexar.
   Summary	Sí	Max. 100 characters
   Description	No	Supports Markdown Format

6. Configure el origen del código:

   Para Code Source, seleccione Local Repository y haga clic en Create Repository.

   Para obtener más información, consulte Use an Enterprise Edition instance to build images.

7. Envíe la imagen personalizada a una instancia de ACR en la misma cuenta.

   1. En la página Repository Repositories, haga clic en Manage en la columna Actions del repositorio deseado.

   2. En el panel de navegación izquierdo, seleccione Details.

      Siga las instrucciones en la sección Instructions on Images en la parte inferior de la página Details para enviar una imagen personalizada desde su entorno de Docker al repositorio de imágenes de Container Registry.

   3. (Opcional) Si su máquina se encuentra en una VPC, realice los siguientes pasos:

      1. Configure el control de acceso para que la VPC se conecte a la instancia Enterprise Edition. Para obtener más información, consulte Configure access over a VPC.

      2. Cuando trabaje con una instancia de ACR Enterprise Edition en un entorno de Docker, debe agregar vpc al nombre de dominio. Por ejemplo, debe cambiar acr-test-registry.cn-wulanchabu.cr.aliyuncs.com por acr-test-registry-vpc.cn-wulanchabu.cr.aliyuncs.com.

         $ docker login --username=***@test.aliyunid.com acr-test-registry.cn-wulanchabu.cr.aliyuncs.com

      Nota

      Si ocurre un error al iniciar sesión en la instancia, compruebe si el acceso a la red pública está habilitado para el repositorio.

Paso 5: Agregar la imagen a MaxCompute

Asocie una imagen existente de ACR con MaxCompute para gestionar de forma centralizada sus imágenes de desarrollo.

1. Inicie sesión en la consola de MaxCompute y seleccione una región en la esquina superior izquierda.

2. En el panel de navegación izquierdo, elija Manage Configurations > Images .

3. En la página Images, haga clic en la pestaña Custom Image.

4. En la pestaña Custom Image, haga clic en Create Image. En el cuadro de diálogo Add Image, configure los siguientes parámetros:

   Nota

   Al crear una imagen por primera vez, aparece el cuadro de diálogo MaxCompute Service-linked Role. Haga clic en OK. El sistema crea automáticamente un rol vinculado al servicio para acceder a los recursos de ACR.

   Parámetro	Descripción
   Image Name	Obligatorio. El nombre de la imagen personalizada. The image name must start with a lowercase letter, and can contain only lowercase letters, digits, hyphens (-), and underscores (_). Este nombre se utiliza para hacer referencia a la imagen en MaxCompute SQL, PyODPS y MaxFrame.
   Image Type	Obligatorio. El tipo de imagen de ACR. Solo se admiten imágenes de ACR Enterprise Edition.
   Enterprise Edition Image Instance	Obligatorio. Seleccione la instancia Enterprise Edition que creó en ACR.
   Image Namespace	Obligatorio. Seleccione el namespace de imagen que creó en ACR.
   Image Repository	Obligatorio. Seleccione el repositorio de imágenes que creó en ACR.
   Image Version	Obligatorio. Seleccione la versión de la imagen que cargó en ACR.
   Image Description	Obligatorio. Agregue una descripción para la imagen.

   Haga clic en OK. La nueva imagen personalizada aparecerá en la lista de imágenes personalizadas.

Paso 6: Usar la imagen

Las imágenes personalizadas pueden referenciarse en UDF de MaxCompute SQL, PyODPS y MaxFrame.

• Para UDF, utilice indicadores a nivel de sesión para especificar la imagen y la versión de Python. Ejemplo:

  set odps.sql.python.version=cp37;
  set odps.session.image = <image_name>;

• Para PyODPS, utilice el parámetro image de los métodos execute o persist para especificar la imagen. Ejemplo:

  Nota

  Para hacer referencia a una imagen en PyODPS, debe actualizar PyODPS a la versión V0.11.5 o posterior.

  image='<image_name>'

• Para MaxFrame, utilice la siguiente configuración para especificar la imagen del trabajo:

  config.options.sql.settings = {
      "odps.session.image": "<image_name>"
  }