기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon ECR 프라이빗 리포지토리에 Docker 이미지 푸시
<a name="docker-push-ecr-image"></a>

**docker push** 명령을 사용하여 컨테이너 이미지를 Amazon ECR 리포지토리로 푸시할 수 있습니다.

Amazon ECR은 다중 아키텍처 이미지에 사용되는 Docker 매니페스트 목록 생성 및 푸시도 지원합니다. 자세한 내용은 [Amazon ECR 리포지토리에 다중 아키텍처 이미지 푸시](docker-push-multi-architecture-image.md) 단원을 참조하세요.

**Amazon ECR 리포지토리에 Docker 이미지를 푸시하려면**

이미지를 푸시하기 전에 Amazon ECR 리포지토리가 존재하거나 리포지토리 생성 템플릿이 정의되어 있어야 합니다. 자세한 내용은 [이미지를 저장할 Amazon ECR 프라이빗 리포지토리 생성](repository-create.md) 및 [풀스루 캐시, 푸시 시 생성 또는 복제 작업 중에 생성된 리포지토리를 제어하는 템플릿](repository-creation-templates.md) 섹션을 참조하세요.

1. 이미지를 푸시하려는 Amazon ECR 레지스트리에 대해 Docker 클라이언트를 인증합니다. 인증 토큰은 사용되는 레지스트리마다 필요하며, 12시간 동안 유효합니다. 자세한 정보는 [Amazon ECR의 프라이빗 레지스트리 인증](registry_auth.md)을 참조하세요.

   Amazon ECR 레지스트리에 대해 Docker를 인증하려면 **aws ecr get-login-password** 명령을 실행합니다. Amazon ECR 인증 토큰을 **docker login** 명령에 전달할 때 사용자 이름으로 `AWS` 값을 사용하고, 인증하려는 Amazon ECR 레지스트리 URI를 지정합니다. 여러 레지스트리에 대해 인증하는 경우 각 레지스트리에 대해 명령을 반복해야 합니다.
**중요**  
오류가 발생하면 최신 버전의 AWS CLI를 설치하거나 업그레이드합니다. 자세한 내용은 *AWS Command Line Interface 사용자 가이드*에서 [AWS Command Line Interface설치](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)를 참조하세요.

   ```
   aws ecr get-login-password --region <region> | docker login --username AWS --password-stdin <aws_account_id>.dkr.ecr.<region>.amazonaws.com
   ```

1. 아직 푸시하려는 레지스트리에 이미지 리포지토리가 없고 리포지토리 생성 템플릿이 정의된 경우 리포지토리 생성 템플릿의 접두사와 원하는 리포지토리 이름을 사용하여 이미지를 푸시할 수 있습니다. ECR은 리포지토리 생성 템플릿의 사전 정의된 설정을 사용하여 리포지토리를 자동으로 생성합니다.

   일치하는 리포지토리 생성 템플릿이 정의되지 않은 경우 리포지토리를 생성해야 합니다. 자세한 내용은 [풀스루 캐시, 푸시 시 생성 또는 복제 작업 중에 생성된 리포지토리를 제어하는 템플릿](repository-creation-templates.md) 또는 [이미지를 저장할 Amazon ECR 프라이빗 리포지토리 생성](repository-create.md)을 참조하세요.

1. 푸시할 로컬 이미지를 식별합니다. **docker images** 명령을 실행하여 시스템에 있는 컨테이너 이미지를 나열합니다.

   ```
   docker images
   ```

   명령 결과 출력에서 *repository:tag* 값 또는 이미지 ID를 확인하여 이미지를 식별할 수 있습니다.

1. <a name="image-tag-step"></a>사용할 Amazon ECR 레지스트리, 리포지토리 및 이미지 태그 이름 조합(선택 사항)이 있는 이미지에 태그를 지정합니다. 레지스트리 형식은  `aws_account_id.dkr.ecr.region.amazonaws.com`입니다. 리포지토리 이름은 이미지에 대해 생성한 리포지토리와 일치해야 합니다. 이미지 태그를 생략하면 태그가 `latest`인 것으로 간주됩니다.

   다음 예시에서는 ID * e9ae3c220b23*을 로 사용하여 로컬 이미지에 태그를 지정합니다`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>**docker push** 명령을 사용하여 이미지를 푸시합니다.

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

1. (선택 사항) [Step 4](#image-tag-step)과 [Step 5](#image-push-step)(을)를 반복하여 이미지에 추가 태그를 적용하고 이러한 태그를 Amazon ECR에 푸시합니다.