Todos los productos
Search
Centro de documentos

Container Registry:Envío y extracción de imágenes en una instancia Personal Edition

Última actualización: Sep 02, 2026

Docker es una plataforma de containerization, pero no ofrece hosting nativo de imágenes. Puede enviar imágenes Docker a una instancia Container Registry (ACR) Personal Edition para obtener servicios básicos de imágenes de contenedor, hosting seguro de imágenes y permitir que otros usuarios extraigan las imágenes.

Requisitos previos

Paso 1: Obtener el nombre de usuario del registro

Inicie sesión en la Container Registry console. En la página de administración de la instancia Personal Edition, seleccione Repository > Access Credentials para obtener su nombre de usuario.

  • Si utiliza una cuenta de Alibaba Cloud, el nombre de su cuenta es su nombre de usuario del registro.

  • Si utiliza un usuario RAM, su nombre de usuario del registro corresponde a la parte de su nombre de usuario RAM anterior al sufijo .onaliyun.com. Por ejemplo, si su usuario RAM es XXX@10051309672****.onaliyun.com, su nombre de usuario del registro es XXX@10051309672****.

Paso 2: Establecer la contraseña de inicio de sesión del registro

Restablecer contraseña

Si olvidó su contraseña de inicio de sesión del registro, puede restablecerla mediante la configuración de una contraseña fija.

  1. Inicie sesión en la Container Registry console.

  2. En la barra de navegación superior, seleccione una región.

  3. En el panel de navegación izquierdo, haga clic en Instances.

  4. En la página Instances, haga clic en la instancia Personal Edition que desea gestionar.

  5. En la página de administración de la instancia Personal Edition, seleccione Repository > Access Credentials.

  6. En la página Access Credentials, haga clic en Set Password y siga las instrucciones para restablecer su contraseña.

    Nota

    Container Registry Personal Edition no admite el uso de la operación de API GetAuthorizationToken para obtener un nombre de usuario y una contraseña temporales para iniciar sesión en la instancia. Se recomienda utilizar una contraseña fija para iniciar sesión.

Configuración inicial de contraseña

Si inicia sesión en la consola de Container Registry por primera vez, debe establecer una contraseña de inicio de sesión del registro para enviar y extraer imágenes.

  1. Inicie sesión en la Container Registry console.

  2. En la página Instances, haga clic en la instancia Personal Edition que desea gestionar.

  3. En el cuadro de diálogo Tips, haga clic en Activate Now y luego haga clic en Reset Docker Login Password.

  4. En el cuadro de diálogo Reset Docker Login Password, introduzca su contraseña en los campos Password y Confirm Password, y luego haga clic en Confirm.

Paso 3: Crear un espacio de nombres

Un espacio de nombres permite gestionar un conjunto de repositorios de imágenes, incluidas sus permisos y propiedades.

  1. Inicie sesión en la Container Registry console.

  2. En la barra de navegación superior, seleccione una región.

  3. En el panel de navegación izquierdo, haga clic en Instances.

  4. En la página Instances, haga clic en la instancia Personal Edition que desea gestionar.

  5. En la página de administración de la instancia Personal Edition, seleccione Repository > Namespace.

  6. En la página Namespace, haga clic en Create Namespace.

  7. En el cuadro de diálogo Create Namespace, introduzca un nombre de espacio de nombres y haga clic en Confirm.

Paso 4: Crear un repositorio de imágenes

  1. Inicie sesión en la Container Registry console.

  2. En el panel de navegación izquierdo, haga clic en Instances.

  3. En la página Instances, haga clic en la instancia Personal Edition que desea gestionar.

  4. En la página de administración de la instancia Personal Edition, seleccione Repository > Repositories.

  5. En la página Repositories, haga clic en Create Repository.

  6. En el paso Repository Info, configure Namespace, Repository Name, Repository Type, Summary y Description. A continuación, haga clic en Next.

    Nota

    El nombre del repositorio debe tener entre 2 y 64 caracteres. Puede contener letras minúsculas, dígitos, guiones bajos (_), guiones (-) y puntos (.). El nombre no puede comenzar ni terminar con un guion bajo y no puede contener barras diagonales (/).

  7. En el paso Code Source, configure Code Source, Build Settings y Build Rules. Luego, haga clic en Create Repository.

    Parámetro

    Descripción

    Code Source

    Seleccione un origen de código.

    Importante

    Antes de seleccionar un origen de código, asegúrese de haber vinculado una plataforma de código fuente. Para más información, consulte Link a source code hosting platform.

    Build Settings

    • Automatically Build Images When Code Changes: Si selecciona esta opción, las reglas de compilación se activan automáticamente cuando se confirma código en una rama.

    • Build with Servers Deployed Outside Chinese Mainland: Si selecciona esta opción, las imágenes se compilan en un centro de datos fuera de China continental y luego se envían a la región especificada tras una compilación exitosa.

    • Build Without Cache: Si selecciona esta opción, las imágenes base de dependencias se vuelven a extraer forzosamente en cada compilación, lo que incrementa el tiempo de compilación.

    Build Rules Setting

    Después de crear el repositorio, vaya a la página de compilación para configurar las reglas de compilación. Para más información, consulte Build a repository and an image.

Paso 5: Enviar y extraer una imagen

A partir del 9 de septiembre de 2024, el formato de los endpoints de registro para las nuevas instancias Personal Edition cambiará. Para más información, consulte Usage notes for new Personal Edition instances. Elija un método para enviar y extraer imágenes según la versión de su instancia.

Nota

Debido a problemas de red de los operadores, la extracción de imágenes desde registros en el extranjero mediante la función de acelerador de imágenes puede fallar. Para más información, consulte [[Product Change] Announcement on adjustments to the ACR image accelerator feature](t2730864.xdita#).

Nuevas instancias Personal Edition

  1. Inicie sesión en la Container Registry console. En la página de administración de la instancia Personal Edition, seleccione Repository > Access Credentials para obtener el comando de inicio de sesión.

    Ejecute el siguiente comando para iniciar sesión en el repositorio de imágenes.

    docker login --username=<registry-username> crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com

    Cuando se le solicite, introduzca la contraseña que estableció en Step 2: Set the registry login password. Un mensaje login succeeded indica que el inicio de sesión fue exitoso.

  2. Envíe la imagen.

    1. Ejecute el siguiente comando para etiquetar la imagen.

      docker tag <image-ID> crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>
    2. Ejecute el siguiente comando para enviar la imagen a su instancia Personal Edition.

      docker push crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

      En la página Repositories, haga clic en el nombre del repositorio destino y luego seleccione Image Version. Si puede ver la imagen enviada en la página Image Version, el envío fue exitoso.

  3. Ejecute el siguiente comando para extraer la imagen.

    docker pull crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

    Ejecute el comando docker images. Si la imagen extraída aparece en la salida del comando, la extracción fue exitosa.

Instancias Personal Edition anteriores

  1. Ejecute el siguiente comando para iniciar sesión en el repositorio de imágenes. Para obtener el comando de inicio de sesión, inicie sesión en la Container Registry console y, en la página de administración de la instancia Personal Edition, seleccione Repository > Access Credentials.

    docker login --username=<registry-username> registry.cn-<region-of-your-instance>.aliyuncs.com

    Cuando se le solicite, introduzca la contraseña que estableció en Step 2: Set the registry login password. Un mensaje login succeeded indica que el inicio de sesión fue exitoso.

  2. Envíe la imagen.

    1. Ejecute el siguiente comando para etiquetar la imagen.

      docker tag <image-ID> registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>
    2. Ejecute el siguiente comando para enviar la imagen a su instancia Personal Edition.

      docker push registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

      En la página Repositories, haga clic en el nombre del repositorio destino y luego seleccione Image Version. Si puede ver la imagen enviada en la página Image Version, el envío fue exitoso.

  3. Ejecute el siguiente comando para extraer la imagen.

    docker pull registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

    Ejecute el comando docker images. Si la imagen extraída aparece en la salida del comando, la extracción fue exitosa.

Operaciones relacionadas

Eliminación masiva de etiquetas de imagen

  1. Inicie sesión en la Container Registry console.

  2. En la barra de navegación superior, seleccione una región.

  3. En el panel de navegación izquierdo, haga clic en Instances.

  4. En la página Instances, haga clic en la instancia Personal Edition que desea gestionar.

  5. En la página de administración de la instancia Personal Edition, seleccione Repository > Repositories y luego haga clic en el nombre del repositorio destino.

  6. En el panel de navegación a la izquierda de la página de detalles del repositorio, haga clic en Image Version.

  7. En la página Image Version, seleccione el icono Batch delete a la izquierda de Tag y haga clic en Batch Delete.

  8. En el cuadro de diálogo de confirmación, seleccione I am sure to delete the images of these tags y haga clic en Confirm.