ワーカープールを管理する

このページでは、ワーカープールに関する情報の表示とワーカープールの削除について説明します。

必要なロール

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
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 リージョンに置き換えます。