Memeriksa penggunaan Container Registry

Jalankan alat ini untuk menentukan apakah ada penggunaan Container Registry dalam project, folder, atau organisasi Google Cloud Anda.

Sebelum memulai

  1. Install the Google Cloud CLI.

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

    gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menemukan penggunaan Container Registry di project, folder, atau organisasi Google Cloud, minta administrator untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menemukan penggunaan Container Registry

Anda dapat menjalankan alat yang dicakupkan ke satu project, folder, atau organisasi Google Cloud.

project

Jalankan perintah berikut untuk menemukan penggunaan Container Registry di project Google Cloud Anda.

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

Dengan PROJECT sebagai project ID Google Cloud Anda. Untuk informasi tentang cara menemukan project ID, lihat Mengidentifikasi project.

Alat ini menampilkan daftar lokasi host Anda untuk project yang ditentukan, dan status penggunaannya. Status penggunaan didefinisikan sebagai berikut:

  • ACTIVE: Penggunaan Container Registry telah terjadi dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • INACTIVE: Tidak ada penggunaan Container Registry dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • REDIRECTED: project telah dialihkan ke Artifact Registry, tetapi masih memiliki bucket Cloud Storage Container Registry. Project ini akan terus berfungsi setelah Container Registry dinonaktifkan dan tidak diperlukan tindakan lebih lanjut. Anda dapat mengurangi biaya dengan menghapus bucket Cloud Storage Container Registry.
  • REDIRECTION_INCOMPLETE: permintaan dialihkan ke Artifact Registry, tetapi data masih disalin dari Container Registry.
  • LEGACY: Penggunaan Container Registry tidak diketahui. Status ini disebabkan oleh project Container Registry lama yang menyimpan file metadata image container di bucket Cloud Storage. Untuk mengetahui informasi selengkapnya tentang project Container Registry lama, lihat Perubahan penyimpanan metadata image container.

Jika alat mengalami error, seperti izin yang tidak ada untuk melihat bucket Cloud Storage atau project Container Registry, Anda akan melihat pesan error yang mirip dengan berikut:

 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

folder

Jalankan perintah berikut untuk menemukan penggunaan Container Registry di folder Google Cloud Anda.

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

Dengan FOLDER sebagai ID folder Google Cloud Anda. Untuk informasi tentang cara mencantumkan folder di organisasi Anda, lihat Mencantumkan folder.

Alat ini menampilkan daftar status penggunaan berikut:

  • ACTIVE: Penggunaan Container Registry telah terjadi dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • INACTIVE: Tidak ada penggunaan Container Registry dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • REDIRECTED: project telah dialihkan ke Artifact Registry, tetapi masih memiliki bucket Cloud Storage Container Registry. Project ini akan terus berfungsi setelah Container Registry dinonaktifkan dan tidak diperlukan tindakan lebih lanjut. Anda dapat mengurangi biaya dengan menghapus bucket Cloud Storage Container Registry.
  • REDIRECTION_INCOMPLETE: permintaan dialihkan ke Artifact Registry, tetapi data masih disalin dari Container Registry.
  • LEGACY: Penggunaan Container Registry tidak diketahui. Status ini disebabkan oleh project Container Registry lama yang menyimpan file metadata image container di bucket Cloud Storage. Untuk mengetahui informasi selengkapnya tentang project Container Registry lama, lihat Perubahan penyimpanan metadata image container.

Jika alat mengalami error, seperti izin yang tidak ada untuk melihat bucket Cloud Storage atau project Container Registry, Anda akan melihat pesan error yang mirip dengan berikut:

 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

organisasi

Jalankan perintah berikut untuk menemukan penggunaan Container Registry di organisasi Google Cloud Anda.

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

Dengan ORGANIZATION sebagai ID organisasi Google Cloud Anda. Untuk mengetahui informasi tentang cara menemukan ID organisasi, lihat Mendapatkan ID resource organisasi.

Alat ini menampilkan daftar status penggunaan berikut:

  • ACTIVE: Penggunaan Container Registry telah terjadi dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • INACTIVE: Tidak ada penggunaan Container Registry dalam 30 hari terakhir. Lokasi dan project host tidak dialihkan.
  • REDIRECTED: project telah dialihkan ke Artifact Registry, tetapi masih memiliki bucket Cloud Storage Container Registry. Project ini akan terus berfungsi setelah Container Registry dinonaktifkan dan tidak diperlukan tindakan lebih lanjut. Anda dapat mengurangi biaya dengan menghapus bucket Cloud Storage Container Registry.
  • REDIRECTION_INCOMPLETE: permintaan dialihkan ke Artifact Registry, tetapi data masih disalin dari Container Registry.
  • LEGACY: Penggunaan Container Registry tidak diketahui. Status ini disebabkan oleh project Container Registry lama yang menyimpan file metadata image container di bucket Cloud Storage. Untuk mengetahui informasi selengkapnya tentang project Container Registry lama, lihat Perubahan penyimpanan metadata image container.

Jika alat mengalami error, seperti izin yang tidak ada untuk melihat bucket Cloud Storage atau project Container Registry, Anda akan melihat pesan error yang mirip dengan berikut:

 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 hasil

Untuk mengontrol item resource yang tercantum, teruskan flag --filter=EXPRESSION. Jika ekspresi bernilai benar untuk item tertentu, item tersebut akan dicantumkan.

Untuk mencantumkan semua penggunaan Container Registry yang aktif di organisasi, Anda dapat memfilter berdasarkan penggunaan aktif:

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

Untuk menemukan semua project yang belum dialihkan, Anda dapat memfilter menurut usage!=REDIRECTED:

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

Untuk informasi selengkapnya tentang ekspresi filter, jalankan gcloud topic filters atau baca dokumentasi referensi.

Langkah selanjutnya