Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Autenticación con repositorios de imágenes

En este tema se describe cómo autenticarse en repositorios de imágenes en línea con Elastic Beanstalk. En el caso de los repositorios privados, Elastic Beanstalk debe autenticarse antes de que pueda extraer e implementar las imágenes. En el caso de Amazon ECR Public, la autenticación es opcional, pero ofrece límites de velocidad más altos y una fiabilidad mejorada.

Uso de imágenes de un repositorio de Amazon ECR

Puede almacenar sus imágenes de Docker personalizadas AWS con Amazon Elastic Container Registry (Amazon ECR).

Cuando guarda sus imágenes de Docker en Amazon ECR, Elastic Beanstalk se autentica automáticamente en el registro de Amazon ECR con el perfil de instancia del entorno. Por lo tanto, es necesario que proporcione a las instancias permiso para obtener acceso a las imágenes del repositorio de Amazon ECR. Para ello, añada permisos al perfil de instancia de su entorno adjuntando la política EC2 ContainerRegistryReadOnly gestionada por Amazon al perfil de instancia. Esto proporciona acceso de solo lectura a todos los repositorios de Amazon ECR de la cuenta. También puede obtener acceso a un único repositorio mediante la siguiente plantilla para crear una política personalizada:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "AllowEbAuth",
            "Effect": "Allow",
            "Action": [
                "ecr:GetAuthorizationToken"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "AllowPull",
            "Effect": "Allow",
            "Resource": [
                "arn:aws:ecr:us-east-2:111122223333:repository/repository-name"
            ],
            "Action": [
                "ecr:GetAuthorizationToken",
                "ecr:BatchCheckLayerAvailability",
                "ecr:GetDownloadUrlForLayer",
                "ecr:GetRepositoryPolicy",
                "ecr:DescribeRepositories",
                "ecr:ListImages",
                "ecr:BatchGetImage"
            ]
        }
    ]
}

Sustituya el nombre de recurso de Amazon (ARN) en la política anterior por el ARN del repositorio.

Debe especificar la información de imagen en el archivo Dockerrun.aws.json. La configuración será diferente en función de la plataforma que utilice.

En la plataforma Docker administrada por ECS, utilice la clave image en un objeto de la definición de contenedor :

"containerDefinitions": [
        {
        "name": "my-image",
        "image": "account-id.dkr.ecr.us-east-2.amazonaws.com/repository-name:latest",

Para la plataforma Docker, consulte la imagen por URL. La URL figura en la definición Image del archivo Dockerrun.aws.json:

  "Image": {
      "Name": "account-id.dkr.ecr.us-east-2.amazonaws.com/repository-name:latest",
      "Update": "true"
    },

Usando AWS Secrets Manager

Configure Elastic Beanstalk para que se autentique en su repositorio privado antes de la implementación a fin de permitir el acceso a las imágenes del contenedor.

Este enfoque utiliza la fase de precompilación del proceso de implementación de Elastic Beanstalk con dos componentes:

Los scripts de enlace recuperan un nombre de usuario y una contraseña de las variables de entorno que se rellenan a partir de un único AWS Secrets Manager secreto en formato JSON. Esta función requiere las plataformas Docker de Elastic Beanstalk y Docker gestionadas por ECS lanzadas a partir del 13 de enero de 2026. Para obtener más información, consulte los secretos del entorno.

Una vez que se haya configurado la autenticación, Elastic Beanstalk puede extraer e implementar imágenes desde el repositorio privado.

Uso del archivo Dockerrun.aws.json

En esta sección se describe otro enfoque para que Elastic Beanstalk se autentique en un repositorio privado. Con este enfoque, se genera un archivo de autenticación con el comando Docker y, a continuación, se carga el archivo de autenticación en un bucket de Amazon S3. También debe incluir la información del bucket en el archivo Dockerrun.aws.json.

Cuando Elastic Beanstalk pueda autenticarse con el registro en línea que aloja el repositorio privado, se podrán implementar y extraer sus imágenes.

Uso de imágenes de Amazon ECR Public

Amazon ECR Public es un registro público de contenedores que aloja imágenes de Docker. Si bien los repositorios de Amazon ECR Public son de acceso público, la autenticación proporciona límites de velocidad más altos y una mayor fiabilidad para las implementaciones.

Para habilitar la autenticación de Amazon ECR Public, añada los siguientes permisos al perfil de instancia de su entorno. Para obtener más información acerca de Amazon ECR Public, consulte Registry authentication in Amazon ECR Public en la Guía del usuario de Amazon Elastic Container Registry Public:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
       {
          "Effect": "Allow",
          "Action": [
             "ecr-public:GetAuthorizationToken",
             "sts:GetServiceBearerToken"
          ],
          "Resource": "*"
       }
    ]
}

Una vez que estos permisos estén asociados al perfil de instancia, Elastic Beanstalk se autenticará automáticamente en los registros de Amazon ECR Public. Puede hacer referencia a las imágenes de Amazon ECR Public utilizando el formato public.ecr.aws/registry-alias/repository-name:tag estándar de su archivo Dockerrun.aws.json o Dockerfile.