Container Registry 사용량 확인

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

시작하기 전에

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

필요한 역할

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

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

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를 실행하거나 참고 문서를 확인하세요.

다음 단계