このページでは、ワーカープールに関する情報の表示とワーカープールの削除について説明します。
必要なロール
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 CLI を使用して、プロジェクトで使用可能なワーカープールのリストを表示します。
gcloud
プロジェクト内のワーカープールを一覧表示するには:
gcloud beta run worker-pools list
割り当てられたラベルなど、ワーカープール定義のプロパティを基準にこのリストをフィルタできます。
ワーカープールの詳細を表示する
Google Cloud CLI を使用して、ワーカープールの詳細を表示します。
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 リージョンに置き換えます。
既存のワーカープールを無効にする
ワーカープールを無効にすると、そのワーカープールのすべてのインスタンスがシャットダウンされます。ワーカープールを無効にするには、次のコマンドを使用してスケーリングをゼロに設定します。
gcloud beta run worker-pools update WORKER_POOL --scaling=0
WORKER_POOL は、ワーカープールの名前に置き換えます。
既存のワーカープールを削除する
ワーカープールを削除する場合は、次の点に注意してください。
- ワーカープールを削除すると、ワークロードを処理しているかどうかにかかわらず、このワーカープールに関連するすべてのリソースが削除されます。このワーカープールのリビジョンもすべて削除されます。
- ワーカープールを削除しても、Artifact Registry からコンテナ イメージが自動的に削除されることはありません。削除されたリビジョンで使用されているコンテナ イメージを Artifact Registry から削除するには、イメージの削除をご覧ください。
- ワーカープールを削除しても、削除が完全に完了するまで、Google Cloud CLI にはワーカープールが表示されます。ただし、ワーカープールを更新することはできません。
ワーカープールを削除すると、元に戻すことはできません。元に戻すことや復元することはできません。
gcloud
ワーカープールを削除するには、次のコマンドを使用します。
gcloud beta run worker-pools delete WORKER_POOL --region REGION
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。