Container Registry の使用状況を確認する

このツールを実行して、Google Cloud プロジェクト、フォルダ、組織内で Container Registry が使用されているかどうかを確認します。

始める前に

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

必要なロール

Google Cloud プロジェクト、フォルダ、または組織で Container Registry の使用状況を確認するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

Google Cloud プロジェクト、フォルダ、または組織に対する Cloud Asset 閲覧者（roles/cloudasset.viewer）
Google Cloud プロジェクト、フォルダ、または組織に対するストレージオブジェクト閲覧者（roles/storage.objectViewer）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Container Registry の使用状況を確認する

このツールは、1 つの Google Cloud プロジェクト、フォルダ、または組織に限定して実行できます。

project

次のコマンドを実行して、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 プロジェクトの詳細については、コンテナイメージのメタデータストレージの変更をご覧ください。

 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 プロジェクトの詳細については、コンテナイメージのメタデータストレージの変更をご覧ください。

 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 に移行します。