Container Registry 종료 준비

Container Registry 종료에 대비하기 위해 다음 단계를 확인하세요.

Container Registry는 지원 중단되었으며 2025년 3월 18일에 종료됩니다. Artifact Registry는 Google Cloud에서 컨테이너 이미지 스토리지 및 관리를 위해 권장되는 서비스입니다. Artifact Registry는 Container Registry와 같은 동일한 컨테이너 관리 기능을 제공하고 추가 기능 및 이점을 포함합니다.

Container Registry 지원 중단에 대한 자세한 내용은 Container Registry 지원 중단를 참조하세요.

무엇을 해야 하나요?

Container Registry에 계속 사용하려는 컨테이너 이미지가 있거나 App Engine과 같이 Container Registry에 의존하는 서비스를 사용 중이면 Artifact Registry 저장소를 사용하도록 업그레이드해야 합니다.

2025년 3월 18일 이후에는 어떻게 되나요?

Container Registry 종료는 세 가지 단계로 구성됩니다.

  • 2025년 3월 18일부터는 Container Registry에 이미지를 쓸 수 없습니다.
  • 2025년 4월 22일부터는 Container Registry에서 이미지를 읽을 수 없습니다.
  • 2025년 5월 22일부터는 Artifact Registry에서 gcr.io 저장소를 설정하는 단계를 완료한 경우 gcr.io 엔드포인트로 푸시하면 Artifact Registry에 이미지가 저장됩니다. 모든 Container Registry 저장소가 Artifact Registry에서 제공됩니다. Artifact Registry에 복사되지 않은 Container Registry의 이미지는 사용할 수 없습니다.

Container Registry 사용량 식별 및 전환 옵션 선택

  1. Google Cloud 프로젝트, 폴더, 조직 내에서 Container Registry 사용량을 식별합니다. Container Registry 사용 도구를 사용하여 Container Registry를 사용 중인지 확인할 수 있습니다.

  2. Container Registry에 계속 사용하려는 컨테이너 이미지가 있으면 사용하려는 전환 옵션을 결정합니다.

  3. Container Registry에 저장된 이미지가 필요하지 않으면 Artifact Registry pkg.dev 저장소 또는 Artifact Registry gcr.io 저장소를 설정할 수 있습니다.

    Container Registry와 Artifact Registry 사이의 차이점에 대해 알아보려면 다음을 참조하세요.

전환 도구 사용

자동 마이그레이션 도구를 사용하여 Container Registry에서 Artifact Registry 호스팅 gcr.io 저장소 또는 pkg.dev Artifact Registry 저장소로 전환할 수 있습니다.

다운타임 또는 서비스 중단 없이 Artifact Registry gcr.io 저장소로 Container Registry 엔드포인트를 마이그레이션할 수 있습니다.

자동 마이그레이션 도구는 선택한 전환 경로에 따라 다음 작업을 수행할 수 있습니다.

  • 해당 리전에 나열된 각 gcr.io 프로젝트에 대해 Artifact Registry에 gcr.io 저장소 또는 pkg.dev 저장소를 만듭니다.
  • 각 저장소에 대한 IAM 정책을 제안하고 사용자 환경설정에 따라 정책을 적용하거나 애플리케이션을 건너뜁니다.
  • gcr.io 엔드포인트에서 Artifact Registry로 모든 트래픽을 리디렉션합니다.
  • 이미 리디렉션을 사용 설정했더라도 Container Registry에 저장된 모든 컨테이너 이미지를 Artifact Registry gcr.io 저장소 또는 pkg.dev 저장소에 복사합니다.

자동 마이그레이션 도구 사용 방법에 대한 안내는 Container Registry에서 Artifact Registry로 자동 마이그레이션을 참고하세요.

자동화 및 통합 검증

Cloud Build, Google Kubernetes Engine 또는 Cloud Run Functions와 같은 서비스에서 기존 자동화 및 통합이 예상대로 작동하는지 확인합니다.

Container Registry 이미지 삭제

리디렉션이 사용 설정되었으면 gcr.io 경로에서 이미지를 삭제하는 명령어가 해당 Artifact Registry gcr.io 저장소의 이미지를 삭제하지만 Container Registry 호스트에 저장된 이미지를 삭제하지 않습니다.

선택한 전환 옵션으로 모든 프로젝트가 작동하고 유지하려는 모든 이미지가 Artifact Registry에 복사되었는지 확인한 후에는 Container Registry 스토리지 버킷을 삭제할 수 있습니다. Cloud Storage 버킷을 삭제하는 방법은 Container Registry에서 이미지 삭제를 참조하세요.