Container Registry 사용량 확인

이 도구를 실행하여 Google Cloud 프로젝트, 폴더 또는 조직 내에 Container Registry 사용량이 있는지 확인합니다.

시작하기 전에

Google Cloud CLI를 설치합니다.
gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.
```
gcloud init
```
참고: gcloud CLI를 이전에 설치했으면 gcloud components update를 실행하여 최신 버전을 사용할 수 있는지 확인합니다.

필요한 역할

Google Cloud 프로젝트, 폴더 또는 조직에서 Container Registry 사용량을 찾는 데 필요한 권한을 얻으려면 관리자에게 다음의 IAM 역할을 부여해 달라고 요청하세요.

Google Cloud 프로젝트, 폴더 또는 조직에 대한 Cloud 애셋 뷰어(roles/cloudasset.viewer)
Google Cloud 프로젝트, 폴더 또는 조직에 대한 스토리지 객체 뷰어(roles/storage.objectViewer)

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Container Registry 사용량 찾기

단일 Google Cloud 프로젝트, 폴더 또는 조직으로 범위가 지정된 도구를 실행할 수 있습니다.

프로젝트

다음 명령어를 실행하여 Google Cloud 프로젝트에서 Container Registry 사용량을 찾습니다.

gcloud container images list-gcr-usage \
    --project=PROJECT

여기서 PROJECT는 Google Cloud 프로젝트 ID입니다. 프로젝트 ID를 찾는 방법은 프로젝트 식별을 참조하세요.

이 도구는 지정된 프로젝트의 호스트 위치 목록과 해당 사용량 상태를 반환합니다. 사용량 상태는 다음과 같이 정의됩니다.

ACTIVE: 지난 30일 동안 Container Registry 사용이 발생했습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
INACTIVE: 지난 30일 동안 Container Registry 사용이 발생하지 않았습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
REDIRECTED: 프로젝트가 Artifact Registry로 리디렉션되었지만 여전히 Container Registry Cloud Storage 버킷을 포함합니다. 이 프로젝트는 Container Registry가 종료된 후에도 계속 작동하며 추가 작업이 필요하지 않습니다. Container Registry Cloud Storage 버킷을 삭제하면 비용을 줄일 수 있습니다.
REDIRECTION_INCOMPLETE: 요청이 Artifact Registry로 리디렉션되지만 데이터가 여전히 Container Registry에서 복사됩니다.
LEGACY: Container Registry 사용량을 알 수 없습니다. 이 상태는 컨테이너 이미지 메타데이터 파일을 Cloud Storage 버킷에 저장하는 기존 Container Registry 프로젝트로 인해 발생합니다. 기존 Container Registry 프로젝트에 대한 자세한 내용은 컨테이너 이미지 메타데이터 스토리지 변경을 참조하세요.

도구에 Cloud Storage 버킷 또는 Container Registry 프로젝트를 볼 수 있는 권한 누락과 같은 오류가 발생하면 다음과 유사한 오류 메시지가 표시됩니다.

 repository: us.gcr.io/my-project
      usage: |-
        response: {'status': 401}
        Operation on project 'no-gcr-permission' failed. Caller does not have permission 'storage.objects.list'. To configure permissions, follow instructions at: https://cloud.google.com/container-registry/docs/access-control: None

폴더

다음 명령어를 실행하여 Google Cloud 폴더에서 Container Registry 사용량을 찾습니다.

gcloud container images list-gcr-usage \
    --folder=FOLDER

여기서 FOLDER는 Google Cloud 폴더 ID입니다. 조직의 폴더를 나열하는 방법은 폴더 나열을 참조하세요.

도구에서 다음과 같은 사용량 상태 목록을 반환합니다.

ACTIVE: 지난 30일 동안 Container Registry 사용이 발생했습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
INACTIVE: 지난 30일 동안 Container Registry 사용이 발생하지 않았습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
REDIRECTED: 프로젝트가 Artifact Registry로 리디렉션되었지만 여전히 Container Registry Cloud Storage 버킷을 포함합니다. 이 프로젝트는 Container Registry가 종료된 후에도 계속 작동하며 추가 작업이 필요하지 않습니다. Container Registry Cloud Storage 버킷을 삭제하면 비용을 줄일 수 있습니다.
REDIRECTION_INCOMPLETE: 요청이 Artifact Registry로 리디렉션되지만 데이터가 여전히 Container Registry에서 복사됩니다.
LEGACY: Container Registry 사용량을 알 수 없습니다. 이 상태는 컨테이너 이미지 메타데이터 파일을 Cloud Storage 버킷에 저장하는 기존 Container Registry 프로젝트로 인해 발생합니다. 기존 Container Registry 프로젝트에 대한 자세한 내용은 컨테이너 이미지 메타데이터 스토리지 변경을 참조하세요.

도구에 Cloud Storage 버킷 또는 Container Registry 프로젝트를 볼 수 있는 권한 누락과 같은 오류가 발생하면 다음과 유사한 오류 메시지가 표시됩니다.

 repository: us.gcr.io/my-project
      usage: |-
        response: {'status': 401}
        Operation on project 'no-gcr-permission' failed. Caller does not have permission 'storage.objects.list'. To configure permissions, follow instructions at: https://cloud.google.com/container-registry/docs/access-control: None

조직

다음 명령어를 실행하여 Google Cloud 조직에서 Container Registry 사용량을 찾습니다.

gcloud container images list-gcr-usage \
    --organization=ORGANIZATION

ORGANIZATION은 Google Cloud 조직 ID입니다. 조직 ID를 찾는 방법은 조직 리소스 ID 가져오기를 참조하세요.

도구에서 다음과 같은 사용량 상태 목록을 반환합니다.

ACTIVE: 지난 30일 동안 Container Registry 사용이 발생했습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
INACTIVE: 지난 30일 동안 Container Registry 사용이 발생하지 않았습니다. 호스트 위치와 프로젝트는 리디렉션되지 않습니다.
REDIRECTED: 프로젝트가 Artifact Registry로 리디렉션되었지만 여전히 Container Registry Cloud Storage 버킷을 포함합니다. 이 프로젝트는 Container Registry가 종료된 후에도 계속 작동하며 추가 작업이 필요하지 않습니다. Container Registry Cloud Storage 버킷을 삭제하면 비용을 줄일 수 있습니다.
REDIRECTION_INCOMPLETE: 요청이 Artifact Registry로 리디렉션되지만 데이터가 여전히 Container Registry에서 복사됩니다.
LEGACY: Container Registry 사용량을 알 수 없습니다. 이 상태는 컨테이너 이미지 메타데이터 파일을 Cloud Storage 버킷에 저장하는 기존 Container Registry 프로젝트로 인해 발생합니다. 기존 Container Registry 프로젝트에 대한 자세한 내용은 컨테이너 이미지 메타데이터 스토리지 변경을 참조하세요.

도구에 Cloud Storage 버킷 또는 Container Registry 프로젝트를 볼 수 있는 권한 누락과 같은 오류가 발생하면 다음과 유사한 오류 메시지가 표시됩니다.

 repository: us.gcr.io/my-project
      usage: |-
        response: {'status': 401}
        Operation on project 'no-gcr-permission' failed. Caller does not have permission 'storage.objects.list'. To configure permissions, follow instructions at: https://cloud.google.com/container-registry/docs/access-control: None

결과 필터링

나열할 리소스 항목을 제어하려면 --filter=EXPRESSION 플래그를 전달합니다. 지정된 항목에 대해 표현식이 true로 평가되면 해당 항목이 나열됩니다.

조직의 모든 활성 Container Registry 사용량을 나열하려면 활성 사용량을 기준으로 필터링하면 됩니다.

gcloud container images list-gcr-usage \
    --organization=ORGANIZATION \
    --filter="usage=ACTIVE"

아직 리디렉션되지 않은 모든 프로젝트를 찾으려면 usage!=REDIRECTED로 필터링하면 됩니다.

gcloud container images list-gcr-usage \
    --organization=ORGANIZATION \
    --filter="usage!=REDIRECTED"

필터 표현식에 대한 자세한 내용은 gcloud topic filters를 실행하거나 참고 문서를 확인하세요.

다음 단계

사용할 전환 옵션을 결정하기
자동 마이그레이션 도구를 사용하여 Artifact Registry로 전환하기