Amazon ECR에서 지원하는 컨테이너 이미지 매니페스트 형식

Amazon ECR는 다음과 같은 컨테이너 이미지 매니페스트 형식을 지원합니다.

• Docker 이미지 매니페스트 V2 스키마 1(Docker 버전 1.9 이하에서 사용됨)

• 도커 이미지 매니페스트 V2 스키마 2(Docker 버전 1.10 이상에서 사용됨)

• Open Container Initiative(OCI) 사양(v1.0 및 v1.1)

도커 이미지 매니페스트 V2 스키마 2를 지원하면 다음 기능을 사용할 수 있습니다.

• 단일 이미지에 여러 개의 태그 사용 기능입니다.

• Windows 컨테이너 이미지 저장 지원.

Amazon ECR 이미지 매니페스트 전환

Amazon ECR에 이미지를 푸시하고 가져오면, 컨테이너 엔진 클라이언트(예: Docker)가 레지스트리와 통신하여 이미지에 사용할 레지스트리 및 클라이언트가 인식할 수 있는 매니페스트 형식으로 일치시킵니다.

Docker 버전 1.9 이하를 사용하여 Amazon ECR에 이미지를 푸시하는 경우, Docker 이미지 매니페스트 V2 스키마 1 형식으로 이미지 매니페스트 형식이 저장됩니다. Docker 버전 1.10 이상을 사용하여 Amazon ECR에 이미지를 푸시하는 경우, Docker 이미지 매니페스트 V2 스키마 2 형식으로 이미지 매니페스트 형식이 저장됩니다.

태그로 Amazon ECR에서 이미지를 가져오는 경우 Amazon ECR은 리포지토리에 저장된 이미지 매니페스트 형식을 반환합니다. 해당 형식을 클라이언트에서 인식할 수 있는 경우에만 형식이 반환됩니다. 저장된 이미지 매니페스트 형식을 클라이언트에서 인식하지 못하면 Amazon ECR은 이미지 매니페스트를 클라이언트에서 인식하는 형식으로 변환합니다. 예를 들어 Docker 1.9 클라이언트는 Docker 이미지 매니페스트 V2 Schema 2로 저장되는 이미지 매니페스트를 요청하고, Amazon ECR은 Docker 이미지 매니페스트 V2 스키마 1 형식으로 매니페스트를 반환합니다. 다음 표에서는 태그로 이미지를 가져올 때 Amazon ECR에서 지원하는 사용 가능한 변환에 대해 설명합니다.

클라이언트에서 요청하는 스키마	V2 스키마 1 형식으로 ECR에 푸시함	V2 스키마 2 형식으로 ECR에 푸시함	OCI 형식으로 ECR에 푸시함
V2 스키마 1	변환이 필요하지 않음	V2 스키마 1 형식으로 변환됨	변환 불가능
V2 스키마 2	변환 불가능, 클라이언트가 V2 스키마 1로 폴백됨	변환이 필요하지 않음	V2 스키마 2 형식으로 변환됨
OCI	변환 불가능	OCI 형식으로 변환됨	변환이 필요하지 않음

중요

이미지를 다이제스트로 가져오는 경우, 사용할 수 있는 변환이 없습니다. 클라이언트는 Amazon ECR에 저장된 이미지 매니페스트 형식을 이해하고 있어야 합니다. 사용자가 Docker 1.9 이하 클라이언트에서 다이제스트를 기준으로 Docker 이미지 매니페스트 V2 스키마 2를 요청하는 경우 이미지 가져오기가 실패합니다. 자세한 내용은 Docker 설명서의 레지스트리 호환성을 참조하세요.

이 예에서 태그로 동일한 이미지를 요청하는 경우, Amazon ECR에서 클라이언트에서 인식할 수 있는 형식으로 이미지 매니페스트를 변환합니다. 그리고 이미지 가져오기가 성공합니다.