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 設定は 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 コンソール、gcloud CLI、YAML、または Terraform を使用します。
コンソール
Google Cloud コンソールで、[Cloud Run] ページに移動します。
Cloud Run ナビゲーション メニューから [ジョブ] を選択します。
新しいジョブを作成する場合は、[コンテナをデプロイ] をクリックして、ジョブの初期設定ページに入力します。
既存のジョブを構成する場合は、ジョブを選択して [ジョブ構成の表示と編集] をクリックします。
[コンテナ、接続、セキュリティ] をクリックして、ジョブのプロパティ ページを開きます。
[コンテナ] タブで、[CPU] リストから CPU の上限を選択します。
1、2、4、6、または8個の CPU を選択します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。[作成] または [更新] をクリックします。
gcloud
新しいジョブを作成するときに CPU の上限を設定するには、次のコマンドを実行します。
gcloud run jobs create JOB --image IMAGE_URL --cpu CPU
次のように置き換えます。
JOB: Cloud Run ジョブの名前。IMAGE_URL: コンテナ イメージへの参照（例:us-docker.pkg.dev/cloudrun/container/job:latest）。CPU: CPU の上限。CPU の値は1、2、4、6、8のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。
既存のジョブの CPU の上限を更新するには、次のコマンドを実行します。
gcloud run jobs update JOB --cpu CPU
YAML
新しいジョブを作成する場合は、この手順をスキップします。既存のジョブを更新する場合は、その YAML 構成をダウンロードします。
gcloud run jobs describe JOB --format export > job.yaml
cpu属性を更新します。apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - image: IMAGE_URL resources: limits: cpu: CPU
次のように置き換えます。
JOB: Cloud Run ジョブの名前。IMAGE_URL: コンテナ イメージへの参照（例:us-docker.pkg.dev/cloudrun/container/job:latest）。CPU: CPU の上限。CPU の値は1、2、4、6、8のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。
次のコマンドを使用して、ジョブを作成または更新します。
gcloud run jobs replace job.yaml
gcloud run jobs replaceコマンドは、存在する場合はデフォルトでjob.yamlファイルを使用します。
Terraform
Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。
Terraform 構成のgoogle_cloud_run_v2_job リソースに次の内容を追加します。resource "google_cloud_run_v2_job" "default" {
name = "JOB"
location = "REGION"
deletion_protection = false
template {
template {
containers {
image = "us-docker.pkg.dev/cloudrun/container/job"
resources {
limits = {
cpu = "CPU"
}
}
}
}
}
}
次のように置き換えます。
JOB: Cloud Run ジョブの名前。REGION: Google Cloud のリージョン。例:europe-west1CPU: CPU の上限。CPU の値は1、2、4、6、8のいずれかに指定します。ジョブには 1 個以上の CPU が必要です（必要な設定については、CPU の上限の設定と更新の表を参照）。
CPU 設定を表示する
Cloud Run ジョブの現在の CPU の設定を表示するには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。
コンソール
Google Cloud コンソールで、Cloud Run の [ジョブ] ページに移動します。
ジョブをクリックして、[ジョブの詳細] ページを開きます。
[ジョブ構成の表示と編集] をクリックします。
構成の詳細で CPU の設定を見つけます。
gcloud
次のコマンドを実行します。
gcloud run jobs describe JOB
返された構成で、CPU 設定を見つけます。