このページでは、Cloud Run インスタンスごとに使用する CPU の数を指定する方法について説明します。デフォルトでは、Cloud Run コンテナ インスタンスは 1 つの CPU に制限されています。この値は、このページの説明に従って増減できます。
CPU 上限の設定と更新
デフォルトでは、各インスタンスの CPU は 1 つに制限されています。この値は、次の表に示す値に変更できます。
CPU とメモリの表
CPU のメモリ要件は次のとおりです。
| 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 |
必要なロール
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 ワーカープールの CPU 上限は、Google Cloud コンソール、Google Cloud CLI、YAML、Terraform のいずれかを使用して設定できます。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択し、[コンテナをデプロイ] をクリックして新しいワーカープールを構成します。既存のワーカープールを構成する場合は、ワーカープールをクリックし、[新しいリビジョンの編集とデプロイ] をクリックします。
新しいワーカープールを構成する場合は、最初のワーカープール ページに入力してから、[コンテナ、ボリューム、ネットワーキング、セキュリティ] をクリックしてワーカープール構成ページを開きます。
[コンテナ] タブをクリックします。
- [CPU] プルダウン リストから CPU の上限を選択します。
[作成] または [デプロイ] をクリックします。
gcloud
次のコマンドを使用して、特定のワーカープールの CPU の上限を更新します。
gcloud beta run worker-pools update WORKER_POOL --cpu CPU
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- CPU は、CPU の上限に置き換えます。CPU とメモリの表に示されている要件に沿って、
1、2、4、6、8のいずれかの値を指定します。
次のコマンドを使用して、デプロイ中に CPU を設定することもできます。
gcloud beta 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
新しいワーカープールを作成する場合は、この手順をスキップします。既存のワーカープールを更新する場合は、その YAML 構成をダウンロードします。
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
次の例には、YAML 構成が含まれています。
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/launch-stage: BETA 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 の上限の設定と更新の表を参照）。
次のコマンドを使用して、ワーカープールを作成または更新します。
gcloud beta run worker-pools replace workerpool.yaml
Terraform
Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
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 構成を確認する
Google Cloud コンソールで Cloud Run に移動します。
[ワーカープール] をクリックして、デプロイされたワーカープールのリストを確認します。
調べるワーカープールをクリックして、詳細ウィンドウを表示します。
[コンテナ] タブをクリックして、ワーカープールの CPU 構成を確認します。