ワーカープールの CPU 上限を構成する

vCPU の上限を設定、更新する

vCPU とメモリの表

vCPU のメモリ要件は次のとおりです。

CPU 必要なメモリ
1 vCPU 512 MiB ～ 4 GiB
2 vCPU 512 MiB ～ 8 GiB
4 vCPU 2～16 GiB
6 vCPU 4～24 GiB
8 vCPU 4～32 GiB

1 より大きい値は整数値にする必要があります。

vCPU の最大数

構成できる vCPU の最大数は 8 vCPU です。

vCPU の最小量

vCPU の最小設定は 1 vCPU です。

費用に関する考慮事項

Cloud Run リソースの費用は、CPU 構成やリソースのアクティブ時間などの要因によって影響を受けます。リソースをオーバー プロビジョニングすると、費用が増加する可能性があります。リソースに最適な CPU 構成を判断するには:

  1. CPU 使用率と費用のバランスが取れた CPU 上限の初期ベースライン構成を確立します。
  2. 負荷テスト中に Cloud Monitoring で CPU 使用率の指標をモニタリングします。
  3. 必要に応じて CPU 構成を調整します。

ピーク時の CPU 使用率が常に低い場合は、vCPU の割り当てを減らすことを検討してください。レイテンシが高い場合は、vCPU の割り当てを増やすことを検討してください。

リソースの費用の概要データ、使用率データ、費用の最適化に関する推奨事項は、Cloud Hub の [最適化] ページで確認できます。詳細については、Cloud Run の料金を確認するか、料金計算ツールで費用を見積もります。

必要なロール

Cloud Run のワーカープールの構成とデプロイに必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run ワーカープールがGoogle Cloud API（Cloud クライアント ライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

CPU 上限を構成する

構成を変更すると、新しいリビジョンが作成されます。明示的に更新しない限り、以降のリビジョンでも、この構成が自動的に設定されます。

Cloud Run ワーカープールの CPU 上限は、Google Cloud コンソール、Google Cloud CLI、YAML、Terraform のいずれかを使用して設定できます。

コンソール

  1. Google Cloud コンソールで、[Cloud Run] ページに移動します。

    Cloud Run に移動

  2. Cloud Run のナビゲーション メニューから [ワーカープール] を選択します。

    1. 既存のワーカープールを構成する場合は、ワーカープールをクリックし、[新しいリビジョンの編集とデプロイ] をクリックします。

    2. 新しいワーカープールを構成する場合は、[コンテナをデプロイ] をクリックし、最初のワーカープール ページに入力します。[コンテナ、ネットワーキング、セキュリティ] をクリックして、ワーカープール構成ページを開きます。

  3. [コンテナ] タブをクリックします。

  4. [CPU] リストから CPU の上限を選択します。

  5. [作成] または [デプロイ] をクリックします。

gcloud

次のコマンドを使用して、特定のワーカープールの CPU の上限を更新します。

gcloud run worker-pools update WORKER_POOL --cpu CPU

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

  • WORKER_POOL は、ワーカープールの名前に置き換えます。
  • CPU は、CPU の上限に置き換えます。CPU とメモリの表に示されている要件に沿って、1、2、4、6、8 のいずれかの値を指定します。

次のコマンドを使用して、デプロイ中に CPU を設定することもできます。

gcloud run worker-pools deploy --image IMAGE_URL --cpu CPU

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

  • IMAGE_URL: ワーカープールを含むコンテナ イメージへの参照（例: us-docker.pkg.dev/cloudrun/container/worker-pool:latest）。
  • CPU は、CPU とメモリの表に示されている要件に沿って、1、2、4、6、8 のいずれかの値に置き換えます。

YAML

  1. 新しいワーカープールを作成する場合は、この手順をスキップします。既存のワーカープールを更新する場合は、その YAML 構成をダウンロードします。

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

  2. 次の例には、YAML 構成が含まれています。

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        resources:
          limits:
            cpu: `CPU`

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

    • WORKER_POOL: Cloud Run ワーカープールの名前
    • IMAGE_URL: ワーカープールを含むコンテナ イメージへの参照（us-docker.pkg.dev/cloudrun/container/worker-pool:latest など）。
    • CPU: CPU の上限値。1、2、4、6、8 のいずれかの値を指定します。CPU が 1 未満の場合は 0.08 から 1.00 までの範囲の値を 0.01 単位で指定します（必要な設定については、CPU の上限の設定と更新の表を参照）。

  3. 次のコマンドを使用して、ワーカープールを作成または更新します。

    gcloud run worker-pools replace worker-pool.yaml

    gcloud run worker-pools replace コマンドは、worker-pool.yaml ファイルが存在する場合はデフォルトでそのファイルを使用します。

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
      resources {
        limits = {
          cpu = "CPU"
        }
      }
    }
  }
}

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

  • WORKER_POOL: ワーカープールの名前。
  • REGION: Google Cloud リージョン（例: europe-west1）。
  • IMAGE_URL: ワーカープールを含むコンテナ イメージへの参照（例: us-docker.pkg.dev/cloudrun/container/worker-pool:latest）
  • CPU は、CPU とメモリの表に示されている要件に沿って、1、2、4、6、8 のいずれかの値に置き換えます。

ワーカープールの CPU 構成を確認する

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

    [Cloud Run] に移動

  2. [ワーカープール] をクリックして、デプロイされたワーカープールのリストを確認します。

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

  4. [コンテナ] タブをクリックして、ワーカープールの CPU 構成を確認します。