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

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

必要なロール

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 を使用して、プロジェクトで使用可能なワーカープールの一覧を表示します。

Console

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択します。使用可能なワーカープールがページに一覧表示されます。

gcloud

プロジェクト内のワーカープールを一覧表示するには:

gcloud beta run worker-pools list

割り当てられたラベルなど、ワーカープール定義のプロパティを基準にこのリストをフィルタできます。

ワーカープールの詳細を表示する

Google Cloud CLI を使用して、ワーカープールの詳細を表示します。

Console

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。

  3. ワーカープールをクリックして、詳細ウィンドウを表示します。

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

既存のワーカープールを無効にする

ワーカープールを無効にすると、そのワーカープールのすべてのインスタンスがシャットダウンされます。ワーカープールを無効にするには、スケーリングをゼロに設定します。

Console

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択し、ワーカープールのリストから無効にするワーカープールをクリックします。

  3. [スケーリング: 手動(インスタンス: )] の右にあるペンアイコンをクリックし、値を 0 に変更します。

  4. [保存] をクリックして、ワーカープールを更新して無効にします。

gcloud

gcloud beta run worker-pools update WORKER_POOL --scaling=0

WORKER_POOL は、ワーカープールの名前に置き換えます。

既存のワーカープールを削除する

ワーカープールを削除する場合は、次の点に注意してください。

  • ワーカープールを削除すると、ワークロードを処理しているかどうかにかかわらず、このワーカープールに関連するすべてのリソースが削除されます。このワーカープールのリビジョンもすべて削除されます。
  • ワーカープールを削除しても、Artifact Registry からコンテナ イメージが自動的に削除されることはありません。削除されたリビジョンで使用されているコンテナ イメージを Artifact Registry から削除するには、イメージの削除をご覧ください。
  • ワーカープールを削除すると、削除が完全に完了するまで、ワーカープールは Google Cloud CLI に表示されたままになります。ただし、ワーカープールを更新することはできません。
  • ワーカープールを削除すると、元に戻すことはできません。元に戻すことや復元することはできません。

Console

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択し、ワーカープールのリストから削除するワーカープールを選択します。

  3. [削除] をクリックします。

gcloud

ワーカープールを削除するには、次のコマンドを使用します。

gcloud beta run worker-pools delete WORKER_POOL --region REGION

次のように置き換えます。

  • WORKER_POOL は、ワーカープールの名前に置き換えます。
  • REGION は、ワーカープールの Google Cloud リージョンに置き換えます。