Container Registry는 지원 중단되었으며 종료될 예정입니다. 2024년 5월 15일부터 Artifact Registry는 이전 Container Registry를 사용하지 않고 프로젝트의 gcr.io 도메인 이미지를 호스팅합니다. 2025년 3월 18일 이후에는 Container Registry가 종료됩니다.
다음 지원 중단 알림은 Container Registry에도 적용됩니다. Docker의 지원 중단 알림과 관련 changelog도 확인하세요.
Docker Registry v1 API 및 Docker 클라이언트 버전 1.6 미만
2016년 12월 14일, 우리는 2017년 2월 28일 Docker v1.13 출시와 동시에 Docker Engine의 v1 프로토콜 지원은 중단된다고 발표했습니다.
그에 따라 Container Registry는 Docker 클라이언트 버전 1.6 미만을 지원하지 않게 되었습니다. 2017년 2월 28일이 지나면 Docker 클라이언트 버전 1.6 미만은 Container Registry API와 통신할 수 없으며, Container Registry에 저장된 v1 프로토콜의 모든 컨테이너 이미지는 제공할 수 없게 됩니다.
이 변경 사항이 이미지에 영향을 주는지 확인하려면 다음 단계를 수행하세요.
다음 명령어를 실행해 사용 중인 Docker 클라이언트 버전을 확인합니다.
gcloud docker -- --version
클라이언트 버전이 1.6 미만이라면 Docker 클라이언트를 업데이트해야 합니다. 그런 다음 이미지를 Docker Registry v2 프로토콜로 업데이트합니다.
영향을 받는 v1 이미지를 가져옵니다.
gclouddocker-- pull gcr.io/[PROJECT-ID]/[IMAGE]
이미지를 다시 내보냅니다.
gclouddocker-- push gcr.io/[PROJECT-ID]/[IMAGE]
Docker Registry의 v1 및 v2 프로토콜에 대한 자세한 내용은 컨테이너 이미지 형식을 참조하세요.
비표준 Container Registry 버킷
2017년 2월 28일부터 b.gcr.io 및 bucket.gcr.io 등의 “버킷 자체 조달” 레지스트리 사용에 대한 지원이 중단됩니다. Container Registry는 더 이상 이러한 버킷에서 호스팅되는 컨테이너 이미지를 제공하지 않습니다.
이미지를 계속 사용하려면 gcr.io, us.gcr.io, asia.gcr.io 또는 eu.gcr.io와 같은 표준 Container Registry 위치로 이미지를 이동해야 합니다.
컨테이너 이미지를 비표준 버킷에서 표준 버킷으로 마이그레이션하려면 다음 단계를 수행하세요.
2017년 2월 28일부로 Container Registry가 이미지 메타데이터 파일을 저장하는 위치가 변경되었습니다. 이미지 메타데이터는 이미지를 구성하는 레이어 파일을(다이제스트를 기준으로) 식별하는 이미지 이름, 이미지 태그, 이미지 매니페스트 같은 정보를 의미합니다.
(삭제할 변경 내역 또는 객체 수명 주기 관리 등을 위해) Cloud Storage 버킷의 메타데이터 파일에 직접 액세스하거나 파일을 조작한다면 이 변경 사항의 영향을 받게 됩니다.
이전에는 이미지를 Container Registry로 내보내면 Container Registry API가 프로젝트의 Cloud Storage 버킷에 있는 해당 이미지의 메타데이터와 레이어 파일을 저장했습니다. 2017년 2월 28일부터 Container Registry는 성능 및 기능 향상을 위해 이미지 메타데이터를 고성능 백엔드 데이터베이스에 저장합니다. 이미지 레이어 파일은 계속 Cloud Storage에 저장됩니다.
Container Registry 서비스 계정이 [PROJECT-NUMBER]@containerregistry.iam.gserviceaccount.com과 비슷한 이름으로 프로젝트에 자동으로 추가되었습니다.
이 서비스 계정은 새로운 Container Registry API를 사용 설정하고 마이그레이션을 관리합니다. 이 서비스 계정을 삭제 또는 다운그레이드하거나 새 Container Registry API를 비활성화하지 마세요.
gcloud docker 명령어 및 Docker 클라이언트 버전 18.03 이상
2018년 4월 3일부터 gcloud docker가 Docker 클라이언트 버전 18.03 이상에서 지원되지 않습니다.
클라이언트 버전 18.03 이상의 Container Registry에 대한 요청을 인증하려면 gcloud를 Docker 사용자 인증 정보 도우미로 사용하세요. 이렇게 하려면 다음 명령어를 실행하세요.
[[["이해하기 쉬움","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 no longer supports Docker clients below version 1.6, and any v1 protocol images became inaccessible after February 28, 2017, requiring users to update their Docker client and their image format if they were still using v1.\u003c/p\u003e\n"],["\u003cp\u003eAs of February 28, 2017, non-standard "bring-your-own-bucket" registries like \u003ccode\u003eb.gcr.io\u003c/code\u003e are deprecated, meaning images in those locations need to be migrated to standard locations like \u003ccode\u003egcr.io\u003c/code\u003e to be served.\u003c/p\u003e\n"],["\u003cp\u003eContainer Registry changed its metadata storage on February 28, 2017, moving image metadata to a high-performance backend database, though layer files remain in Cloud Storage, and this also saw the addition of a service account for migration that should not be deleted.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egcloud docker\u003c/code\u003e command is not supported for Docker client versions above 18.03 as of April 3, 2018, so users with newer clients must use \u003ccode\u003egcloud auth configure-docker\u003c/code\u003e or another advanced authentication method for Container Registry.\u003c/p\u003e\n"]]],[],null,["# Feature deprecations\n\nThe following deprecation notices affect Container Registry. See also\nDocker's [deprecation notices](https://docs.docker.com/engine/deprecated/)\nand their [changelog](https://github.com/moby/moby/blob/master/CHANGELOG.md).\n| **Note:** Beginning March 1, 2017, Docker is on a monthly release cycle that uses a year-month (YY.MM) versioning scheme. Previously, Docker used a major, minor, and patch versioning scheme (formatted as X.X.X) ; the last release to use this scheme was 1.13.1. For more information, see [Docker's notice](https://github.com/moby/moby/blob/master/CHANGELOG.md#17030-ce-2017-03-01) about this change.\n\nDocker Registry v1 API and Docker clients below version 1.6\n-----------------------------------------------------------\n\nOn December 14, 2016, we announced that, as of February 28, 2017, with the\nrelease of Docker v1.13, the Docker Engine no longer supports the\n[v1 protocol](https://docs.docker.com/engine/deprecated/#interacting-with-v1-registries).\n\nAs a result, Container Registry no longer supports Docker clients below version\n1.6. After February 28, 2017, Docker clients below version 1.6 cannot\ncommunicate with the Container Registry API, and any container images\nin v1 protocol stored in Container Registry are no longer servable.\n\nTo see if this change affects your images, perform these steps:\n\n1. Check which Docker client version you're using by running the following\n command:\n\n gcloud docker -- --version\n\n If your client version is lower than version 1.6, you must update your\n Docker client. Then, you must update your images to the Docker Registry v2\n protocol.\n2. Pull an affected v1 image:\n\n gcloud docker -- pull gcr.io/[PROJECT-ID]/[IMAGE]\n\n3. Push the image again:\n\n gcloud docker -- push gcr.io/[PROJECT-ID]/[IMAGE]\n\nFor more information about Docker Registry's v1 and v2 protocols, see\n[Container Image Formats](/container-registry/docs/concepts/image-formats).\n| **Note:** If you continuously encounter an error such as \"v1 Registry API is disabled\" when pulling or pushing images, ensure that your hostname, project ID, image name, and tag or digest are spelled correctly. For more information, see [Troubleshooting](/container-registry/docs/troubleshooting#error_status_405_v1_registry_api_is_disabled).\n\nNon-Standard Container Registry Buckets\n---------------------------------------\n\nOn February 28th, 2017, the use of \"bring-your-own-bucket\" registries such as\n`b.gcr.io` and `bucket.gcr.io` is deprecated. Container Registry no longer\nserves any container images hosted in those buckets.\n\nTo continue using your images, you must move them into a standard\nContainer Registry location such as `gcr.io`, `us.gcr.io`, `asia.gcr.io`, or\n`eu.gcr.io`.\n\nTo migrate your container images from a non-standard bucket to a standard one,\nperform these steps:\n\n1. Pull the images in the non-standard bucket:\n\n gcloud docker -- pull b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG]\n\n2. Re-tag the images with a standard registry location name:\n\n gcloud docker -- tag b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG] [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]\n\n3. Re-push the image to Container Registry (using Docker client version 1.6\n or later) using the target project ID:\n\n gcloud docker -- push [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]\n\nContainer Image Metadata Storage Change\n---------------------------------------\n\nAs of February 28th, 2017, Container Registry has changed where it stores\ncontainer *image metadata* files. Image metadata refers to information like\nimage names, image tags, and image manifests that identify the layer files\n(by digest) that comprise an image.\n\nThis change might affect you if you directly access or manipulate the metadata\nfiles in your Cloud Storage bucket, such as change history or object lifecycle\nmanagement for deletion.\n\nPreviously, when you pushed an image to Container Registry, the Container Registry\nAPI stored the metadata and layer files for those images in a Cloud Storage\nbucket in your project. As of February 28th, 2017, Container Registry stores\nimage metadata in a high-performance backend database to improve performance and\nfunctionality. The image layer files are still stored in Cloud Storage.\n\nA Container Registry service account was automatically added to your project\nwith a name similar to `[PROJECT-NUMBER]@containerregistry.iam.gserviceaccount.com`.\nThis service account activated the new Container Registry API and managed the\nmigration. Please do not delete or downgrade this service account or de-activate\nthe new Container Registry API.\n| **Note:** If you do delete or downgrade the migration service account, you can re-create it by re-activating the Container Registry API in the Cloud console's [APIs \\& services menu](https://console.cloud.google.com/apis).\n\ngcloud docker command and Docker clients above version 18.03\n------------------------------------------------------------\n\nAs of April 3rd, 2018, `gcloud docker` is not supported for Docker\nclient versions above 18.03.\n\nTo authenticate requests to Container Registry for client versions above 18.03,\nuse `gcloud` as a Docker credential helper. To do so, run the following command: \n\n gcloud auth configure-docker\n\nAlternatively, use one of the other\n[advanced authentication methods](/container-registry/docs/advanced-authentication).\n| **Warning:** You should use a Docker credential helper (that is, `docker-credential-gcr` or `docker-credential-gcloud` via `gcloud auth configure-docker`) only for versions 18.03 or above. A bug in earlier versions of the Docker client slows down `docker build`s dramatically when credential helpers are configured."]]
