기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon ECR 프라이빗 리포지토리에서 로컬 환경으로 이미지 가져오기 Amazon ECR에서 사용할 수 있는 Docker 이미지를 실행하려면 **docker pull** 명령을 사용하여 로컬 환경으로 이미지를 가져옵니다. 기본 레지스트리 또는 다른 AWS 계정과 연결된 레지스트리에서이 작업을 수행할 수 있습니다. Amazon ECS 작업 정의에서 Amazon ECR 이미지를 사용하려면 [Amazon ECS에서 Amazon ECR 이미지 사용](ECR_on_ECS.md) 섹션을 참조하세요. **중요** 아카이브된 이미지는 가져올 수 없습니다. 보관된 이미지를 가져오려면 먼저 복원해야 합니다. 이미지 보관 및 복원에 대한 자세한 내용은 섹션을 참조하세요[Amazon ECR에 이미지 보관](archive_restore_image.md). **중요** Amazon ECR의 요구 사항에 따라 사용자가 레지스트리에 대해 인증하고 Amazon ECR 리포지토리에서 이미지를 푸시 또는 풀하기 전에 IAM 정책을 통해 `ecr:GetAuthorizationToken` API에 호출을 할 권한이 있어야 합니다. Amazon ECR은 다양한 수준에서 사용자 액세스를 제어하는 여러 AWS 관리형 정책을 제공합니다. Amazon ECR의 AWS 관리형 정책에 대한 자세한 내용은 섹션을 참조하세요[AWS Amazon Elastic Container Registry에 대한 관리형 정책](security-iam-awsmanpol.md). **Amazon ECR 리포지토리에서 Docker 이미지를 가져오려면** 1. 이미지를 가져오려는 Amazon ECR 레지스트리에 대해 Docker 클라이언트를 인증합니다. 인증 토큰은 사용되는 레지스트리마다 필요하며, 12시간 동안 유효합니다. 자세한 정보는 [Amazon ECR의 프라이빗 레지스트리 인증](registry_auth.md)을 참조하세요. 1. (선택 사항) 가져올 이미지를 식별합니다. + **aws ecr describe-repositories** 명령을 사용하여 레지스트리에 있는 리포지토리 목록을 표시할 수 있습니다. ``` aws ecr describe-repositories ``` 위의 레지스트리 예제에는 `amazonlinux` 라는 리포지토리가 있습니다. + **aws ecr describe-images** 명령을 사용하여 리포지토리 내에 있는 이미지 목록을 표시할 수 있습니다. ``` aws ecr describe-images --repository-name amazonlinux ``` 위의 예제 리포지토리에는 이미지 다이제스트 `latest`과 함께 `2016.09` 및 ` sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807`라고 태그가 지정된 이미지가 있습니다. 1. **docker pull** 명령을 사용하여 이미지를 풀링합니다. 이미지 이름 형식은 태그를 기준으로 가져오는 경우 `{{registry}}/{{repository}} [:{{tag}}]`, 다이제스트를 기준으로 가져오는 경우 `{{registry}} /{{repository}}[@{{digest}}]`입니다. ``` docker pull {{aws_account_id}}.dkr.ecr.{{us-west-2}}.amazonaws.com/amazonlinux:latest ``` **중요** `{{repository-url}} not found: does not exist or no pull access` 오류가 표시되는 경우 Amazon ECR로 Docker 클라이언트를 인증해야 할 수 있습니다. 자세한 내용은 [Amazon ECR의 프라이빗 레지스트리 인증](registry_auth.md) 단원을 참조하십시오.