ジョブの CPU 上限を構成する

このページでは、Cloud Run インスタンスごとに使用する vCPU の数を指定する方法について説明します。デフォルトでは、Cloud Run コンテナインスタンスは 1 つの vCPU に制限されています。この値は、このページの説明に従って増減できます。

vCPU 上限の設定と更新

デフォルトでは、各インスタンスの vCPU は 1 つに制限されています。この値は、次の表に示す値に変更できます。

vCPU とメモリの表

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

CPU	必要なメモリ
1 vCPU	128 MiB～4 GiB
2 vCPU	128 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 の最小設定は 0.08 vCPU です。

使用する vCPU を 1 未満にする場合は、0.08 から 1 までの範囲の値を 0.001 単位で選択します。

使用する vCPU が 1 未満の場合、次の要件が適用されます。

設定	要件
メモリ	メモリ上限に 512 MiB を超える値を設定するには、0.5 以上の vCPU が必要です。メモリ上限に 1 GiB を超える値を設定するには、1 以上の vCPU が必要です。
同時実行	最大同時実行数は `1` に設定する必要があります。
課金	課金設定がリクエストベースの課金に設定されている必要があります。
コンテナ	複数のコンテナ（サイドカー）をデプロイする必要があります。

費用に関する考慮事項

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

CPU 使用率と費用のバランスが取れた CPU 上限の初期ベースライン構成を確立します。
負荷がかかった状態でシステムをテストしながら、Cloud Monitoring で CPU 使用率指標をモニタリングします。
必要に応じて CPU 構成を調整します。

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

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

必要なロール

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

Cloud Run ジョブに対する Cloud Run デベロッパー（roles/run.developer）
サービス ID に対するサービスアカウントユーザー（roles/iam.serviceAccountUser）

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

CPU 上限を構成する

Cloud Run ジョブには 1 個以上の CPU を設定する必要があります。

Cloud Run ジョブの CPU を指定するには:

コンソール

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

Cloud Run に移動
[コンテナをデプロイ] をクリックして、ジョブの初期設定ページに入力します。既存のジョブを構成する場合は、ジョブを選択して [ジョブ構成の表示と編集] をクリックします。
[コンテナ、接続、セキュリティ] をクリックして、ジョブのプロパティページを開きます。
[全般] タブをクリックします。
- プルダウンリストから目的の CPU の上限を選択します。1、2、4、6、または 8 個の CPU を選択します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。
[作成] または [更新] をクリックします。

gcloud

次のコマンドを使用して、特定のジョブの CPU の上限を更新します。
```
gcloud run jobs update JOB_NAME --cpu CPU
```
次のように置き換えます。
- JOB_NAME は、ジョブの名前に置き換えます。
- CPU は、目的の CPU の上限値に置き換えます。CPU の値は 1、2、4、6、8 のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。
また、次のコマンドを使用してジョブの作成時に CPU を設定することもできます。
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --cpu CPU
```
次のように置き換えます。
- JOB_NAME: ジョブの名前。
- IMAGE_URL: コンテナイメージへの参照（us-docker.pkg.dev/cloudrun/container/job:latest など）。
- CPU は、目的の CPU の上限値に置き換えます。CPU の値は 1、2、4、6、8 のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。

YAML

新しいジョブを作成する場合は、この手順をスキップします。既存のジョブを更新する場合は、その YAML 構成をダウンロードします。
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```
cpu 属性を更新します。
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          resources:
            limits:
              cpu: CPU
```
CPU は、目的の CPU の上限に置き換えます。CPU の値は 1、2、4、6、8 のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。

環境変数やメモリ上限など他の構成を指定することもできます。
既存のジョブ構成を更新します。
```
gcloud run jobs replace job.yaml
```

Terraform

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

Terraform 構成の google_cloud_run_v2_job リソースに次の内容を追加します。

  resource "google_cloud_run_v2_job" "default" {
    name     = "cloudrun-job"
    location = "REGION"
    deletion_protection = false

    template {
      template {
        containers {
          image = "us-docker.pkg.dev/cloudrun/container/job"
          resources {
            limits = {
              cpu    = "CPU"
            }
          }
        }
      }
    }
  }

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

REGION は、 Google Cloud リージョンに置き換えます。例: europe-west1
CPU は、サービスに必要なメモリ上限に置き換えます。CPU の値は 1、2、4、6、8 のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。

CPU 設定を表示する

Cloud Run ジョブの現在の CPU の設定を表示するには:

コンソール

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

Cloud Run の [ジョブ] に移動
目的のジョブをクリックして、[ジョブの詳細] ページを開きます。
[ジョブ構成の表示と編集] をクリックします。
構成の詳細で CPU の設定を見つけます。

gcloud

次のコマンドを使用します。
```
gcloud run jobs describe JOB_NAME
```
返された構成で、CPU 設定を見つけます。

ジョブの CPU 上限を構成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

vCPU 上限の設定と更新

vCPU とメモリの表

vCPU の最大数

vCPU の最小数

費用に関する考慮事項

必要なロール

CPU 上限を構成する

コンソール

gcloud

YAML

Terraform

CPU 設定を表示する

コンソール

gcloud

ジョブの CPU 上限を構成する