このページは Cloud Translation API によって翻訳されました。

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

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

必要なロール

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

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

gcloud

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

gcloud beta run worker-pools list

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

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

Google Cloud コンソール、Google Cloud CLI、または YAML を使用して、ワーカープールの詳細を表示します。

Console

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

Cloud Run に移動
メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。
ワーカープールをクリックして、詳細ウィンドウを表示します。

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

YAML

ワーカープールの詳細を表示するには、その YAML 構成をダウンロードします。

gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

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

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

コンソール

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

Cloud Run に移動
メニューから [ワーカープール] を選択し、ワーカープールの一覧から無効にするワーカープールをクリックします。
[スケーリング: 手動（インスタンス: ）] の右にある鉛筆アイコンをクリックし、値を 0 に変更します。
[保存] をクリックして、ワーカープールを更新して無効にします。

gcloud

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

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

YAML

新しいワーカープールを作成する場合は、この手順をスキップします。既存のワーカープールを更新する場合は、その YAML 構成をダウンロードします。
```
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
```

ワーカープールを無効にするには、スケールを 0 に設定します。次の例には、YAML 構成が含まれています。

apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/scalingMode: manual
    run.googleapis.com/manualInstanceCount: `0`

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

WORKER_POOL: Cloud Run ワーカープールの名前。

次のコマンドを使用して、ワーカープールを作成または更新します。
```
gcloud beta run worker-pools replace workerpool.yaml
```

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

ワーカープールを削除する場合は、次の点を考慮する必要があります。

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

コンソール

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

Cloud Run に移動
メニューから [ワーカープール] を選択し、ワーカープールの一覧から削除するワーカープールを選択します。
[削除] をクリックします。

gcloud

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

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

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

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