Transférer une image Docker vers un référentiel privé Amazon ECR - Amazon ECR

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

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.

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 et Modèles permettant de contrôler les référentiels créés lors d'une opération d'extraction du cache, d'une création en mode push ou d'une action de réplication.

  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.

    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 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
  2. 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 permettant de contrôler les référentiels créés lors d'une opération d'extraction du cache, d'une création en mode push ou d'une action de réplication ou Création d'un référentiel privé Amazon ECR pour stocker des images.

  3. 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.

  4. 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'IDaws_account_id.dkr.ecr.region.amazonaws.com/my-repository:tag.

    docker tag e9ae3c220b23 aws_account_id.dkr.ecr.region.amazonaws.com/my-repository:tag
  5. Transmettez l'image à l'aide de la commande docker push :

    docker push aws_account_id.dkr.ecr.region.amazonaws.com/my-repository:tag
  6. (Facultatif) Appliquez toute balise supplémentaire à l'image et transmettez ces balises à Amazon ECR en répétant Étape 4 et Étape 5.