🐳 Docker manifest 변경?

Docker manifest가 OCI로 바뀐 이유

최근에 이미지 정리 스크립트를 실행하려고 Docker Registry에서 이미지 manifest를 조회했는데, 예전에는 잘 되던 Docker manifest v2 요청이 이제는 404를 반환했습니다. 확인해 보니 이제는 OCI manifest로 조회해야 하더군요.
왜 이런 변화가 생긴 걸까요?

배경: Docker manifest v2 → OCI manifest

예전엔 Docker가 자체적으로 만든 manifest v2 스펙을 사용했습니다.
이건 Docker Hub나 일반 레지스트리에서 이미지 정보를 확인할 때 쓰이던 형식이었죠.

그런데 이후 Docker가 Open Container Initiative(OCI) 에 이미지 스펙을 기부하면서,
이전 스펙을 기반으로 한 공식 표준(OCI Image Specification) 이 생겼습니다.

결국 이제 컨테이너 이미지의 표준 포맷은 Docker 전용이 아니라,
모든 런타임(containerd 등)에서 공통으로 쓰는 OCI 포맷이 된 겁니다.

차이점 정리

항목 Docker Manifest v2 OCI Manifest
미디어 타입

• application/vnd.docker.distribution.manifest.v2+json
• application/vnd.oci.image.manifest.v1+json

왜 바뀌었을까?

표준화 목적

컨테이너 생태계가 Docker 하나로만 돌아가지 않기 때문입니다.
OCI는 모든 런타임이 같은 이미지 포맷을 쓸 수 있게 표준화했습니다.

Docker Engine 업데이트

Docker 20.10(2020년 12월 9일 출시) 이상부터는 OCI 스펙이 기본 지원됩니다.
manifest 명령어(docker manifest inspect)도 내부적으로 OCI 형식을 사용합니다.

레지스트리(Registry) 업데이트

Harbor, GitLab, AWS ECR 등 대부분의 최신 레지스트리는
application/vnd.oci.* 타입을 기본으로 처리하고,
예전 v2 형식은 deprecated 되었습니다.

결론

Docker manifest 조회 시 v2 대신 OCI manifest를 사용하는 이유는
Docker Engine과 Registry 모두 OCI 표준을 채택했기 때문입니다.

즉, Docker만의 형식이 아니라 이제는 모두가 공유하는 컨테이너 이미지 표준으로 넘어간 거죠.

OCI 스펙은 앞으로 SBOM, 서명(Signature), WASM 등 다양한 아티팩트까지 지원하기 때문에
이제 OCI 형식을 사용하는 게 가장 안전하고 확장성 있는 선택입니다.

요약

• Docker v2 → OCI는 표준화 흐름
• Docker Engine 20.10+부터 OCI가 기본
• 최신 Registry들은 v2 manifest 지원 중단
• 앞으로는 OCI manifest 기반으로 관리하는 게 정석

참고 자료

• https://www.docker.com/blog/introducing-docker-engine-20-10/
• https://docs.docker.com/retired/