(GCP) Container Registry to Artifact Registry Migration

date

Mar 19, 2024

slug

artifact-registry-migration

author

status

Public

tags

Archived

summary

Container Registry에서 Artifact Registry로 Migration 과정

type

Post

thumbnail

category

archived-project

updatedAt

Oct 1, 2025 06:23 AM

Index

• Introduction

• Problem

• Artifact Registry

• Hands-On

• Conclusion

Introduction

Problem

갑자기 이런 이메일이 날라오더니 Action Required 라고 제목을 붙여놓더군요.

대부분의 GCP 이메일은 Action이 필요없다고 하는데, 오늘은 달라서 좀 읽어보니까 대충 5월까지는 Registry 이슈를 처리해야했습니다.

요약하자면 “Container Registry 서비스가 Deprecated 될 예정이니까 Artifact Registry 서비스로 Migration해라” 입니다.

Vertex AI 때도 그렇고, 고객입장에서 좀 이런건 자동으로 해주면 좋겠습니다;;;

Artifact Registry

Understanding Artifact Registry vs. Container Registry | Google Cloud Blog

Compared with Container Registry, Artifact Registry lets you store non-container artifacts, and provides better security and more flexibility.

https://cloud.google.com/blog/products/application-development/understanding-artifact-registry-vs-container-registry?hl=en

• Container Image 뿐만 아니라, Maven, npm, Python, apt, yum, Go 등 General한 언어와 연관된 Package를 포함한 여러 ‘Artifact’ 형식을 저장할 수 있습니다.

• gcr.io 단일 호스트 방식에서 → LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY 방식으로 전환함으로써, 멀티 리전 호스트로 대응이 가능해졌습니다. (리전 별로 세분화된 권한, 버전 관리 등등이 가능)

• Repository 단에서 별도 권한 구분이 불가능했던 Container Registry와 달리, Reader, Writer, Administrator 등의 권한 구분이 가능해졌습니다.

• Cloud Storage 사용량이 아닌, 자체가격 책정이 됩니다.

Hands-On

• Artifact Registry 활성화
• Artifact Registry API를 본인의 GCP 내 프로젝트에서 활성화시켜주면 됩니다.

• Create Repository
• 옵션을 지정해서 Repository를 생성해주면 됩니다. 전 직접 이름 할당해서 생성했는데, 아마 기존 Container Registry가 있다면 원클릭으로 Multi Region gcr.io를 생성해줍니다.

• 아래처럼 생성되었다면, Console을 통해 작업을 시작합니다.
• go install github.com/google/go-containerregistry/cmd/gcrane@latest
• IAM 권한 부여 (프로젝트 리소스 관리 페이지에서 Project ID, Project Number 확인 가능합니다.)

gcloud projects add-iam-policy-bindingProject-Id \
    --member='serviceAccount:service-Project-Number@gcp-sa-artifactregistry.iam.gserviceaccount.com' \
    --role='roles/storage.objectViewer'

• gcrane을 통해서 Container Registry에서 이미지를 추출하고 Artifact화하여 생성한 Repository 들에 저장합니다. (Repository 생성 수만큼 아래 명령어를 변경해서 실행합니다.) gcrane cp -r gcr.io/Project-Id us-docker.pkg.dev/Project-Id/{Repository Name}

• 여기까지 했다면, 이제 Artifact Registry는 준비가 끝났습니다…만 아직 Container Registry의 gcr.io로 트래픽이 가고 있기 때문에 리디렉션을 해줘야합니다.
• Artifact Registry 및 Storage Administrator 권한 부여

gcloud projects add-iam-policy-bindingProject-Id \
    --member='user:{gcp user email}' \
    --role='roles/artifactregistry.admin'

gcloud projects add-iam-policy-bindingProject-Id \
    --member='user:{gcp user email}' \
    --role='roles/storage.admin'

• 아래 링크로 들어가면 Artifact Registry 라우팅을 허용할 수 있게 됩니다.

Conclusion