Extrair uma imagem de um repositório ECR privado da Amazon para seu ambiente local

Se você quiser executar uma imagem do Docker que está disponível na AmazonECR, você pode transferi-la para o seu ambiente local com o docker pull comando. Você pode fazer isso a partir do seu registro padrão ou de um registro associado a outra AWS conta.

Para usar uma ECR imagem da Amazon em uma definição de ECS tarefa da Amazon, consulteUso de imagens do Amazon ECR com o Amazon ECS.

Importante

A Amazon ECR exige que os usuários tenham permissão para fazer chamadas para o ecr:GetAuthorizationToken API por meio de uma IAM política antes de poderem se autenticar em um registro e enviar ou extrair qualquer imagem de qualquer ECR repositório da Amazon. ECRA Amazon fornece várias políticas AWS gerenciadas para controlar o acesso do usuário em vários níveis. Para obter informações sobre as políticas AWS gerenciadas da AmazonECR, consulteAWS políticas gerenciadas para o Amazon Elastic Container Registry.

Para extrair uma imagem do Docker de um repositório da Amazon ECR

1. Autentique seu cliente Docker ECR no registro da Amazon do qual você pretende extrair sua imagem. Os tokens de autenticação devem ser obtidos para cada registro usado e são válidos por 12 horas. Para obter mais informações, consulte Autenticação de registro privado na Amazon ECR.

2. (Opcional) Identifique a imagem a ser extraída.

   • É possível listar os repositórios em um registro com o comando aws ecr describe-repositories:

     aws ecr describe-repositories

     O registro de exemplo acima tem um repositório chamado amazonlinux.

   • É possível descrever as imagens em um repositório com o comando aws ecr describe-images:

     aws ecr describe-images --repository-name amazonlinux

     O repositório de exemplo acima tem uma imagem marcada como latest e 2016.09, com o resumo de imagem sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807.

3. Extraia a imagem usando o comando docker pull. O formato de nome de imagem deve ser registry/repository[:tag] para extrair por tag ou registry/repository[@digest] para extrair por resumo.

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

   Importante

   Se você receber um repository-url not found: does not exist or no pull access erro, talvez seja necessário autenticar seu cliente Docker na Amazon. ECR Para obter mais informações, consulte Autenticação de registro privado na Amazon ECR.