지원 중단 알림

다음 지원 중단 알림은 Container Registry에도 적용됩니다. Docker의 지원 중단 알림과 관련 변경 로그도 확인하세요.

Docker Registry v1 API 및 Docker 클라이언트 버전 1.6 미만

2016년 12월 14일에 Google은 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 프로토콜의 모든 컨테이너 이미지는 제공할 수 없게 됩니다.

이 변경 사항이 이미지에 영향을 주는지 확인하려면 다음 단계를 수행하세요.

  1. 다음 명령어를 실행해 사용 중인 Docker 클라이언트 버전을 확인합니다.

      gcloud docker -- --version
    

    클라이언트 버전이 1.6 미만이라면 Docker 클라이언트를 업데이트해야 합니다. 그런 다음 이미지를 Docker Registry v2 프로토콜로 업데이트합니다.

  2. 영향을 받는 v1 이미지를 가져옵니다.

      gcloud docker -- pull gcr.io/[PROJECT-ID]/[IMAGE]
    
  3. 이미지를 다시 내보냅니다.

      gcloud docker -- 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 위치로 이미지를 이동해야 합니다.

컨테이너 이미지를 비표준 버킷에서 표준 버킷으로 마이그레이션하려면 다음 단계를 수행하세요.

  1. 비표준 버킷에 있는 이미지를 가져옵니다.

    gcloud docker -- pull b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG]
    
  2. 표준 레지스트리 위치 이름으로 이미지를 다시 태그 지정합니다.

    gcloud docker -- tag b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG] [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
    
  3. 대상 프로젝트 ID를 이용해 (Docker 클라이언트 버전 1.6 이상을 사용하는) Container Registry로 이미지를 다시 내보냅니다.

    gcloud docker -- push [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
    

컨테이너 이미지 메타데이터 저장소 변경

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 사용자 인증 정보 도우미로 사용하세요. 이렇게 하려면 다음 명령어를 실행하세요.

gcloud auth configure-docker

또는 다른 고급 인증 방식 중 하나를 이용해도 됩니다.