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.

# Inserción de una imagen de Docker en un repositorio privado de Amazon ECR
<a name="docker-push-ecr-image"></a>

Puede insertar las imágenes de contenedor a un repositorio de Amazon ECR con el comando **docker push**.

Amazon ECR también es compatible con la creación e inserción de listas de manifiesto de Docker que se utilizan para imágenes multiarquitectura. Para obtener información, consulte [Inserción de una imagen multiarquitectura a un repositorio privado de Amazon ECR](docker-push-multi-architecture-image.md).

**Inserción de una imagen de Docker en un repositorio de Amazon ECR**

El repositorio de Amazon ECR debe existir antes de insertar la imagen o debe tener definida una plantilla de creación de repositorios. Para obtener más información, consulte [Creación de un repositorio privado de Amazon ECR para almacenar imágenes](repository-create.md) y [Plantillas para controlar los repositorios creados durante una acción de extracción, creación mediante inserción o replicación](repository-creation-templates.md).

1. Autentique su cliente de Docker en el registro de Amazon ECR en el que va a insertar 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](registry_auth.md).

   Para autenticar Docker en un registro de Amazon ECR, ejecute el comando **aws ecr get-login-password**. Al pasar el token de autenticación al comando **docker login**, utilice el valor `AWS` para el nombre de usuario y especifique el URI del registro de Amazon ECR en el que desea autenticarse. Si se autentica en varios registros, deberá repetir el comando con cada registro.
**importante**  
Si recibe un error, instale o actualice a la versión más reciente de la AWS CLI. Para obtener más información, consulte [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) en la *Guía del usuario de AWS Command Line Interface *.

   ```
   aws ecr get-login-password --region {{<region>}} | docker login --username AWS --password-stdin {{<{{aws_account_id}}>}}.dkr.ecr.{{<region>}}.amazonaws.com
   ```

1. Si su repositorio de imágenes aún no existe en el registro al que pretende subirlo y ha definido una plantilla de creación de repositorios, puede insertar la imagen utilizando el prefijo de la plantilla de creación de repositorios y el nombre de repositorio que desee. ECR creará el repositorio automáticamente por usted utilizando la configuración predefinida de su plantilla de creación de repositorios.

   Si no ha definido una plantilla de creación de repositorios coincidente, tendrá que crear un repositorio. Para obtener más información, consulte [Plantillas para controlar los repositorios creados durante una acción de extracción, creación mediante inserción o replicación](repository-creation-templates.md) o [Creación de un repositorio privado de Amazon ECR para almacenar imágenes](repository-create.md).

1. Identifique la imagen local que va a insertar. Ejecute el comando **docker images** para mostrar las imágenes de contenedor en el sistema.

   ```
   docker images
   ```

   Puede identificar una imagen con el {{repository:tag}} valor o el ID de la imagen en el resultado del comando resultante.

1. <a name="image-tag-step"></a>Etiquete su imagen con la combinación de nombres del registro, repositorio y etiqueta de imagen opcional de Amazon ECR que se van a usar. El formato de registro es `{{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com`. El nombre del repositorio debe coincidir con el repositorio que ha creado para su imagen. Si omite la etiqueta de imagen, se presupone que la etiqueta es `latest`.

   En el siguiente ejemplo, se etiqueta una imagen local con el identificador {{ e9ae3c220b23}} como`{{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com/my-repository:tag`.

   ```
   docker tag {{e9ae3c220b23}} {{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com/{{my-repository:tag}}
   ```

1. <a name="image-push-step"></a>Inserte la imagen mediante el comando **docker push**:

   ```
   docker push {{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com/{{my-repository:tag}}
   ```

1. (Opcional) Aplique todas las demás etiquetas a su imagen e insértelas en Amazon ECR repitiendo [Step 4](#image-tag-step) y [Step 5](#image-push-step).