Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Transférer une image Docker vers un référentiel privé Amazon ECR
<a name="docker-push-ecr-image"></a>

Vous pouvez envoyer vos images de conteneur vers un référentiel Amazon ECR à l'aide de la commande **docker push**.

Amazon ECR prend également en charge la création et le transfert de listes de manifestes Docker utilisées pour les images multi-architectures. Pour plus d'informations, consultez [Transmission d'une image multi-architecture vers un référentiel privé Amazon ECR](docker-push-multi-architecture-image.md).

**Pour transmettre une image Docker à un référentiel Amazon ECR**

Le référentiel Amazon ECR doit exister avant que vous ne publiiez l'image, ou vous devez avoir défini un modèle de création de référentiel. Pour plus d’informations, consultez [Création d'un référentiel privé Amazon ECR pour stocker des images](repository-create.md) et [Modèles pour contrôler les référentiels créés lors d'une opération d'extraction du cache, d'une création push ou d'une action de réplication](repository-creation-templates.md).

1. Authentifiez le client Docker auprès du registre Amazon ECR dans lequel vous prévoyez de transmettre votre image. Vous devez obtenir des jetons d'authentification pour chaque registre utilisé ; les jetons sont valides pendant 12 heures. Pour de plus amples informations, veuillez consulter [Authentification du registre privé dans Amazon ECR](registry_auth.md).

   Pour authentifier Docker dans un registre Amazon ECR, exécutez la commande **aws ecr get-login-password**. Lorsque vous passez le jeton d'authentification à la commande **docker login**, utilisez la valeur `AWS` pour le nom d'utilisateur et spécifiez l'URI de registre Amazon ECR auquel vous souhaitez vous authentifier. Si vous vous authentifiez sur plusieurs registres, vous devrez répéter la commande pour chacun d'eux.
**Important**  
Si vous recevez une erreur, installez la dernière version de la CLI ou effectuez une mise à niveau vers cette version AWS CLI. Pour plus d’informations, consultez [Installation d’ AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) dans le *Guide de l’utilisateur 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 votre référentiel d'images n'existe pas encore dans le registre vers lequel vous souhaitez envoyer le transfert, et si un modèle de création de référentiel est défini, vous pouvez transférer votre image en utilisant le préfixe du modèle de création de votre référentiel et le nom de référentiel de votre choix. ECR créera automatiquement le référentiel pour vous en utilisant les paramètres prédéfinis de votre modèle de création de référentiel.

   Si aucun modèle de création de dépôt correspondant n'est défini, vous devez créer un référentiel. Pour plus d’informations, consultez [Modèles pour contrôler les référentiels créés lors d'une opération d'extraction du cache, d'une création push ou d'une action de réplication](repository-creation-templates.md) ou [Création d'un référentiel privé Amazon ECR pour stocker des images](repository-create.md).

1. Identifiez l'image à transmettre. Exécutez la commande **docker images** afin d'afficher la liste des images du conteneur du système.

   ```
   docker images
   ```

   Vous pouvez identifier une image à l'aide de la {{repository:tag}} valeur ou de l'identifiant de l'image dans la sortie de commande qui en résulte.

1. <a name="image-tag-step"></a>Balisez l'image avec la combinaison registre Amazon ECR, référentiel et nom de balise d'image facultatif à utiliser. Le format de registre est `{{aws_account_id}}.dkr.ecr.{{region}}.amazonaws.com`. Le nom du référentiel doit correspondre au référentiel que vous avez créé pour l'image. Si vous omettez la balise de l'image, nous supposerons que c'est `latest`.

   L'exemple suivant balise une image locale avec {{ e9ae3c220b23}} l'ID`{{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>Transmettez l'image à l'aide de la commande **docker push** :

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

1. (Facultatif) Appliquez toute balise supplémentaire à l'image et transmettez ces balises à Amazon ECR en répétant [Step 4](#image-tag-step) et [Step 5](#image-push-step).