Amazon ECR 프라이빗 리포지토리에 Docker 이미지 푸시

Amazon ECR 프라이빗 리포지토리에 Docker 이미지 푸시

docker push 명령어를 사용해 컨테이너 이미지를 Amazon ECR 리포지토리에 푸시하는 방법을 설명합니다. Amazon ECR은 멀티 아키텍처 이미지에 사용되는 Docker 매니페스트 목록(manifest lists)의 생성과 푸시도 지원합니다. 관련 내용은 Amazon ECR 프라이빗 리포지토리에 멀티 아키텍처 이미지 푸시 문서를 참고하세요.

출처: 문서

본문

Docker 이미지를 Amazon ECR 리포지토리에 푸시

  1. 이미지를 푸시하기 전에 Amazon ECR 리포지토리가 존재해야 하며, 리포지토리 생성 템플릿이 정의되어 있지 않으면 먼저 리포지토리를 만들어야 합니다. 자세한 내용은 이미지 저장용 Amazon ECR 프라이빗 리포지토리 생성과 풀 스루 캐시·create on push·복제 작업 중 생성되는 리포지토리를 제어하는 템플릿 문서를 참고하세요.

  2. 이미지를 푸시하려는 Amazon ECR 레지스트리에 Docker 클라이언트를 인증합니다. 인증 토큰은 사용하는 각 레지스트리에 대해 얻어야 하며, 토큰의 유효 기간은 12시간입니다. 자세한 내용은 Amazon ECR의 프라이빗 레지스트리 인증을 참고하세요.

    Docker를 Amazon ECR 레지스트리에 인증하려면 aws ecr get-login-password 명령어를 실행합니다. 인증 토큰을 docker login 명령어에 전달할 때 사용자 이름에는 AWS 값을 사용하고, 인증하려는 Amazon ECR 레지스트리 URI를 지정합니다. 여러 레지스트리에 인증하는 경우 각 레지스트리에 대해 명령어를 반복해 실행해야 합니다.

    중요 오류가 발생하면 AWS CLI를 최신 버전으로 설치하거나 업그레이드하세요. 자세한 내용은 AWS Command Line Interface User Guide의 AWS 명령줄 인터페이스 설치를 참고하세요.

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

    푸시하려는 레지스트리에 이미지 리포지토리가 아직 없고 리포지토리 생성 템플릿이 정의되어 있다면, 템플릿의 접두사와 원하는 리포지토리 이름을 사용해 이미지를 푸시할 수 있습니다. 그러면 ECR이 리포지토리 생성 템플릿의 미리 정의된 설정을 사용해 리포지토리를 자동으로 생성합니다. 일치하는 리포지토리 생성 템플릿이 정의되어 있지 않으면 리포지토리를 직접 만들어야 합니다. 자세한 내용은 풀 스루 캐시·create on push·복제 작업 중 생성되는 리포지토리를 제어하는 템플릿 또는 이미지 저장용 Amazon ECR 프라이빗 리포지토리 생성 문서를 참고하세요.

  3. 푸시할 로컬 이미지를 식별합니다. docker images 명령어를 실행해 시스템의 컨테이너 이미지를 나열합니다.

    docker images

    명령어 출력에서 repository:tag 값이나 이미지 ID로 이미지를 식별할 수 있습니다.

  4. 사용할 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

  5. docker push 명령어를 사용해 이미지를 푸시합니다.

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

  6. (선택 사항) 이미지에 추가 태그를 적용하고 4단계와 5단계를 반복해 해당 태그를 Amazon ECR에 푸시할 수 있습니다.

더 알아보기 (Learn more)