Container Registry는 지원 중단되었으며 종료될 예정입니다. 2024년 5월 15일부터 Artifact Registry는 이전 Container Registry를 사용하지 않고 프로젝트의 gcr.io 도메인 이미지를 호스팅합니다. 2025년 3월 18일 이후에는 Container Registry가 종료됩니다.
매니페스트 목록처럼, 이미지 색인 매니페스트도 여러 이미지 매니페스트를 참조합니다. 이미지 색인은 다중 플랫폼 이미지에 유용합니다.
Docker V1 이미지 형식 지원 중단
2017년 2월 28일부터 Docker V2 레지스트리 사양이 Docker V1 사양을 대체합니다. Docker V1 사양은 더 이상 지원되지 않으며, Docker V1 이미지는 Container Registry와 함께 사용할 수 없습니다.
Docker V2는 콘텐츠 지정 가능 이미지를 허용하고 이미지 레이어 추적을 단순화하는 일련의 변경사항을 Docker 이미지 형식에 적용했습니다.
Docker V2 이미지 매니페스트는 Docker V1 이미지와는 달리, 이미지 레이어의 모든 콘텐츠 주소('다이제스트')를 포함합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eContainer Registry supports Docker Image Manifest V2 (both Schema 1 and Schema 2) and Open Container Initiative (OCI) image formats for container images.\u003c/p\u003e\n"],["\u003cp\u003eDocker V2 images, which supersede the deprecated Docker V1 images, offer content-addressable images and multi-architecture support.\u003c/p\u003e\n"],["\u003cp\u003eManifest lists (for Docker V2) and image indexes (for OCI) allow a single tag or digest to represent multiple versions or platforms of an image.\u003c/p\u003e\n"],["\u003cp\u003eThe Docker V1 image format is deprecated and cannot be used with Container Registry, and all users must use Docker V2 or OCI compatible images.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from Docker V1 to Docker V2 images can be done by pulling existing V1 images with \u003ccode\u003edocker pull\u003c/code\u003e and then pushing them with \u003ccode\u003edocker push\u003c/code\u003e, if using a docker version higher than 1.6.\u003c/p\u003e\n"]]],[],null,["# Container image formats\n\nContainer Registry supports the following container image formats:\n\n- [Docker Image Manifest V2, Schema 1](https://docs.docker.com/registry/spec/manifest-v2-1/)\n- [Docker Image Manifest V2, Schema 2](https://docs.docker.com/registry/spec/manifest-v2-2/)\n- [Open Container Initiative (OCI) Specifications](https://github.com/opencontainers/image-spec)\n\nDocker V2\n---------\n\n[Docker V2 image manifest](https://docs.docker.com/registry/spec/manifest-v2-2/)\nis a specification for container images that allows\nmulti-architecture images and supports content-addressable images.\n\nDocker V2 images supersede Docker V1 images, which are\n[deprecated](/container-registry/docs/support/deprecation-notices#docker_registry_v1_api_and_docker_clients_below_version_16).\n\nManifest lists\n--------------\n\n[Manifest lists](https://docs.docker.com/registry/spec/manifest-v2-2/#manifest-list)\nare part of the Docker V2, Schema 2 and OCI images.\n\nManifest lists allow a single digest or tag to represent multiple forms of an\nimage.\n\nOCI format\n----------\n\nThe OCI format is a specification for container images based on the\nDocker Image Manifest Version 2, Schema 2 format. Container Registry\nsupports pushing and pulling OCI images.\n\nImage indexes\n-------------\n\n[Image indexes](https://github.com/opencontainers/image-spec/blob/28462ef6944123de00cf27e812309cbf5d82da71/image-index.md)\nare the equivalent of manifest lists in OCI images.\n\nLike manifest lists, an image index manifest refers to multiple image\nmanifests. Image indexes are useful for multi-platform images.\n\nDeprecation of Docker V1 image format\n-------------------------------------\n\nAs of February 28, 2017, the [Docker V2 registry\nspecification](https://docs.docker.com/registry/spec/api/)\nreplaced the Docker V1 specification. The Docker V1 specification is deprecated,\nand Docker V1 images cannot be used with Container Registry.\n\nDocker V2 made a set of changes to the Docker image format to allow for\ncontent-addressable images and to remove complexity in tracking image layers.\nDocker V2 image manifests contain all the content addresses (\"digests\") of the\nimage's layers, whereas Docker V1 images did not.\n\nFor more information, refer to\n[Deprecation Notices](/container-registry/docs/support/deprecation-notices).\n\n### Upgrading Docker V1 images to Docker V2 images\n\nTo upgrade your V1 images to V2 images, ensure that Docker v1.6 or higher is\ninstalled. Then, run the following commands to pull and then re-push the\nimages to Container Registry: \n\n docker pull gcr.io/[your-project-id]/[image]:[tag]\n docker push gcr.io/[your-project-id]/[image]:[tag]"]]
