Extracción de una imagen a su entorno local desde un repositorio privado de Amazon ECR - Amazon ECR

Extracción de una imagen a su entorno local desde un repositorio privado de Amazon ECR

Si desea ejecutar una imagen de Docker que está disponible en Amazon ECR, puede extraerla a su entorno local con el comando docker pull. Puede hacerlo desde su registro predeterminado o desde un registro asociado a otra cuenta de AWS.

Para utilizar una imagen de Amazon ECR en una definición de tarea de Amazon ECS, consulte Uso de imágenes de Amazon ECR con Amazon ECS.

importante

Amazon ECR requiere que los usuarios tengan permiso para realizar llamadas a la API ecr:GetAuthorizationToken a través de una política de IAM para que puedan autenticarse en un registro, así como insertar o extraer imágenes de cualquier repositorio de Amazon ECR. Amazon ECR proporciona varias políticas administradas por AWS para controlar el acceso de los usuarios en distintos niveles. Para obtener información acerca de las políticas administradas por AWS para Amazon ECR, consulte Políticas administradas por AWS para Amazon Elastic Container Registry.

Extracción de una imagen de Docker de un repositorio de Amazon ECR

  1. Autentique su cliente de Docker en el registro de Amazon ECR del que va a extraer la imagen. Debe obtener tokens de autenticación para cada registro usado, cuya validez es de 12 horas. Para obtener más información, consulte Autenticación de registro privado en Amazon ECR.

  2. (Opcional) Identifique la imagen que va a extraer.

    • Puede mostrar los repositorios de un registro con el comando: aws ecr describe-repositories.

      aws ecr describe-repositories

      El registro de ejemplo anterior tiene un repositorio llamado amazonlinux.

    • Puede describir las imágenes de un repositorio con el comando: aws ecr describe-images.

      aws ecr describe-images --repository-name amazonlinux

      El repositorio de ejemplo anterior tiene una imagen etiquetada como latest y 2016.09, con el resumen de imagen sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807.

  3. Extraiga la imagen con el comando docker pull. El formato del nombre de imagen debe ser registry/repository[:tag] para extraer la imagen por etiqueta o registry/repository[@digest] para extraerla por resumen.

    docker pull aws_account_id.dkr.ecr.us-west-2.amazonaws.com/amazonlinux:latest
    importante

    Si aparece un error repository-url not found: does not exist or no pull access, es posible que tenga que autenticar su cliente de Docker con Amazon ECR. Para obtener más información, consulte Autenticación de registro privado en Amazon ECR.