このページでは、ワーカープールに関する情報の表示とワーカープールの削除について説明します。
必要なロール
Cloud Run ワーカープールとワーカープール リビジョンを管理するために必要な権限を取得するには、Cloud Run ワーカープールに対する Cloud Run デベロッパー（roles/run.developer）IAM ロールを付与するよう管理者に依頼してください。
Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run ワーカープールがGoogle Cloud API（Cloud クライアント ライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセス権の管理をご覧ください。
ワーカープールを作成する
コンテナ イメージの初回デプロイ時に、Cloud Run によって新しいワーカープールが作成されます。詳細な手順については、新しいワーカープールをデプロイするをご覧ください。
プロジェクト内のワーカープールの一覧を表示する
Google Cloud コンソールまたは Google Cloud CLI を使用して、プロジェクトで使用可能なワーカープールの一覧を表示します。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択します。使用可能なワーカープールがページに一覧表示されます。
gcloud
プロジェクト内のワーカープールを一覧表示するには:
gcloud beta run worker-pools list
割り当てられたラベルなど、ワーカープール定義のプロパティでこの一覧をフィルタできます。
ワーカープールの詳細を表示する
Google Cloud CLI を使用して、ワーカープールの詳細を表示します。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。
ワーカープールをクリックして、詳細ウィンドウを表示します。
gcloud
ワーカープールの詳細を表示するには:
gcloud beta run worker-pools describe WORKER_POOL
--format フラグを使用して出力をフォーマットできます。たとえば、出力を YAML 形式でフォーマットするには、次のようにします。
gcloud beta run worker-pools describe WORKER_POOL --region REGION --format yaml
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。
既存のワーカープールを無効にする
ワーカープールを無効にすると、そのワーカープールのすべてのインスタンスがシャットダウンされます。ワーカープールを無効にするには、スケーリングを 0 に設定します。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択し、ワーカープールの一覧から無効にするワーカープールをクリックします。
[スケーリング: 手動（インスタンス: ）] の右にある鉛筆アイコンをクリックし、値を 0 に変更します。
[保存] をクリックして、ワーカープールを更新して無効にします。
gcloud
gcloud beta run worker-pools update WORKER_POOL --scaling=0
WORKER_POOL は、ワーカープールの名前に置き換えます。
既存のワーカープールを削除する
ワーカープールを削除する場合は、次の点を考慮する必要があります。
- ワーカープールを削除すると、このワーカープールに関連するすべてのリソースが削除されます。ワークロードを処理しているかどうかにかかわらず、このワーカープールのリビジョンもすべて削除されます。
- ワーカープールを削除しても、Artifact Registry からコンテナ イメージが自動的に削除されることはありません。削除されたリビジョンで使用されているコンテナ イメージを Artifact Registry から削除するには、イメージの削除をご覧ください。
- ワーカープールを削除すると、削除が完全に完了するまで、ワーカープールは Google Cloud CLI に表示されたままになります。ただし、ワーカープールを更新することはできません。
ワーカープールの削除は取り消せません。元に戻すことや復元することはできません。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択し、ワーカープールの一覧から削除するワーカープールを選択します。
[削除] をクリックします。
gcloud
ワーカープールを削除するには、次のコマンドを使用します。
gcloud beta run worker-pools delete WORKER_POOL --region REGION
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。