Extraction d'une image vers votre environnement local à partir d'un référentiel ECR privé Amazon - 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.

Extraction d'une image vers votre environnement local à partir d'un référentiel ECR privé Amazon

Si vous souhaitez exécuter une image Docker disponible sur AmazonECR, vous pouvez l'importer dans votre environnement local à l'aide de la docker pull commande. Vous pouvez le faire depuis votre registre par défaut ou depuis un registre associé à un autre AWS compte.

Pour utiliser une ECR image Amazon dans une définition de ECS tâche Amazon, consultezUtiliser des images Amazon ECR avec Amazon ECS.

Important

Amazon ECR exige que les utilisateurs soient autorisés à passer des appels ecr:GetAuthorizationToken API via une IAM politique avant de pouvoir s'authentifier auprès d'un registre et envoyer ou extraire des images d'un ECR référentiel Amazon. Amazon ECR fournit plusieurs politiques AWS gérées pour contrôler l'accès des utilisateurs à différents niveaux. Pour plus d'informations sur les politiques AWS gérées pour AmazonECR, consultezAWS politiques gérées pour Amazon Elastic Container Registry.

Pour extraire une image Docker d'un référentiel Amazon ECR

  1. Authentifiez votre client Docker auprès ECR du registre Amazon à partir duquel vous souhaitez extraire 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é sur Amazon ECR.

  2. (Facultatif) Identifiez l'image à extraire.

    • Vous pouvez consulter une liste des référentiels dans un registre avec la commande aws ecr describe-repositories :

      aws ecr describe-repositories

      L'exemple de registre ci-dessus comporte un référentiel nommé amazonlinux.

    • Vous pouvez décrire les images d'un référentiel à l'aide de la commande aws ecr describe-images :

      aws ecr describe-images --repository-name amazonlinux

      L'exemple de référentiel ci-dessus comporte une image balisée en tant que latest et 2016.09, avec le hachage d'image sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807.

  3. Procédez à l'extraction de l'image à l'aide de la commande docker pull. Le format du nom de l'image doit être registry/repository[:tag] pour une extraction par balise ou registry/repository[@digest] pour une extraction par hachage.

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

    Si vous recevez un repository-url not found: does not exist or no pull access message d'erreur, vous devrez peut-être authentifier votre client Docker auprès d'Amazon. ECR Pour de plus amples informations, veuillez consulter Authentification du registre privé sur Amazon ECR.