CPU の割り当て（サービス）

デフォルトでは、Cloud Run インスタンスにはリクエストの処理中、コンテナの起動中、シャットダウン時にのみ CPU が割り当てられます。（インスタンスのライフサイクルをご覧ください）。この動作を変更すると、受信リクエストがない場合でも CPU が常に割り当て、利用可能な状態にすることができます。CPU を常に割り当てるように設定すると、短期のバックグラウンドタスクやその他の非同期処理タスクの実行に利用できます。

CPU 割り当てモードのイラスト

CPU が常に割り当てられている場合でも、Cloud Run の自動スケーリングは引き続き有効であり、受信トラフィックやリクエスト以外の CPU 使用率の処理に必要ないインスタンスは停止できます。リクエスト処理後 15 分を過ぎるとインスタンスのアイドル状態は解除されます（ただし、最小インスタンス数を使用してアクティブ状態が保持されている場合は除きます）。

CPU に常に多数の最小インスタンスを割り当てると、多数のインスタンスが起動され、CPU リソースへの完全アクセス権が付与されます。これにより、バックグラウンド処理のユースケースが有効になります。このパターンを使用すると、サービスがリクエスト以外で CPU を使用している場合でも、Cloud Run はインスタンスの自動スケーリングを適用します。

ヘルスチェックプローブを使用する場合、CPU はすべてのプローブに割り当てられます。課金の詳細については、コンテナヘルスチェックプローブをご覧ください。

料金への影響

リクエストの処理中にのみ CPU を割り当てる場合は、各リクエストでインスタンスがリクエストを処理した場合にのみ課金されます。CPU の常時割り当てを設定すると、インスタンスのライフサイクル全体で料金が発生します。詳細については、Cloud Run の料金表をご覧ください。

Google の Recommender が、過去 1 か月間に Cloud Run サービスが受信したトラフィックを自動的に調べ、料金が安い場合、リクエスト時に割り当てられる CPU から常に割り当てられる CPU に切り替えるよう推奨します。

適切な CPU 割り当てを選択する方法

ユースケースに適した CPU の割り当ては、トラフィックパターン、バックグラウンド実行、コストなど、いくつかの要素によって異なります。以降のセクションでは、これらの要素について説明します。

トラフィックパターンに関する考慮事項

受信トラフィックが散発的か、バーストまたは急増する場合は、リクエストの処理中にのみ CPU を割り当てることをおすすめします。
受信トラフィックが安定して緩やかであれば、CPU を常に割り当てることをおすすめします。

バックグラウンド実行に関する考慮事項

[CPU を常に割り当てる] を選択すると、レスポンスを返した後に短期のバックグラウンドタスクなどの非同期処理を実行できます。次に例を示します。

バックグラウンドでの実行が想定される OpenTelemetry などのモニタリングエージェントを利用する。
Go の Goroutine、Node.js async、Java スレッド、Kotlin コルーチンを使用する。
組み込みのスケジューリング / バックグラウンド機能に依存するアプリケーションフレームワークを使用する。

アイドル状態のインスタンス（最小インスタンスを使用してウォーム状態を維持したインスタンスを含む）は、いつでもシャットダウンできます。コンテナが終了する前に未処理のタスクを完了する必要がある場合は、SIGTERM をトラップして、インスタンスが停止するまでに 10 秒の猶予期間を設けることができます。

非同期タスクの実行には、Cloud Tasks の使用を検討してください。Cloud Tasks は、失敗したタスクを自動的に再試行し、最大 30 分の実行時間をサポートします。

費用に関する考慮事項

現在、[リクエストの処理中にのみ CPU を割り当てる] を使用していて、次のような場合は、[CPU を常に割り当てる] のほうが経済的です。

Cloud Run サービスが、現在の多くのリクエストを一定の速度で処理している。
インスタンス数の指標で、アイドル状態のインスタンスが多くない。

料金計算ツールを使うと、費用の差額を見積もることができます。

自動スケーリングに関する考慮事項

Cloud Run は、コンテナインスタンスの数を自動スケーリングします。

リクエストの処理中にのみ CPU を割り当てるように設定されたサービスの場合、Cloud Run はリクエストの処理中にのみ CPU 使用率に基づいてインスタンス数を自動スケーリングします。

CPU を常に割り当てるように設定されたサービスの場合、Cloud Run は、コンテナインスタンスのライフサイクル全体で CPU 使用率に基づいてインスタンス数を自動スケーリングします。ただし、ゼロへのスケーリングとゼロからのスケーリングの場合は、リクエストのみを使用します。

必要なロール

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 APIs（Cloud クライアントライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

CPU 割り当ての設定と更新

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

CPU の常時割り当てオプションを選択する場合は、512 MiB 以上のメモリを指定する必要があります。

デフォルトでは、各コンテナインスタンスのリクエストの処理中にのみ CPU が割り当てられます。この設定は、新しいサービスの作成時または新しいリビジョンのデプロイ時に、Google Cloud コンソール、gcloud コマンドライン、YAML ファイルを使用して変更できます。

コンソール

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

Cloud Run に移動
[コンテナをデプロイ] をクリックし、[サービス] を選択して、新しいサービスを構成します。既存のサービスを構成する場合は、サービスをクリックし、[新しいリビジョンの編集とデプロイ] をクリックします。
新しいサービスを構成する場合は、最初のサービス設定のページに入力してから、[コンテナ、ボリューム、ネットワーキング、セキュリティ] をクリックしてサービス構成ページを開きます。
[コンテナ] タブをクリックします。
- [CPU の割り当てと料金] で、目的の CPU 割り当てを選択します。インスタンスがリクエストを受信しているときにのみ CPU を割り当てるようにするには、[リクエストの処理中にのみ CPU を割り当てる] を選択します。インスタンスの存続期間全体で CPU を割り当てる場合は、[CPU を常に割り当てる] を選択します。
[作成] または [デプロイ] をクリックします。

gcloud

CPU 割り当てを更新できます。特定のサービスに対して常に CPU が割り当てられるように設定するには:

gcloud run services update SERVICE --no-cpu-throttling

SERVICE は、実際のサービス名に置き換えます。

リクエストの処理中にのみ CPU を割り当てるように設定するには:

gcloud run services update SERVICE --cpu-throttling

デプロイ中に CPU 割り当てを設定することもできます。CPU を常時割り当てられるように設定するには:

gcloud run deploy --image IMAGE_URL --no-cpu-throttling

リクエストの処理中にのみ CPU を割り当てるように設定するには:

gcloud run deploy --image IMAGE_URL --cpu-throttling

IMAGE_URL は、コンテナイメージへの参照（us-docker.pkg.dev/cloudrun/container/hello:latest など）に置き換えます。Artifact Registry を使用する場合は、リポジトリ REPO_NAME がすでに作成されている必要があります。URL の形式は LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG です。

YAML

新しいサービスを作成する場合は、この手順をスキップします。既存のサービスを更新する場合は、その YAML 構成をダウンロードします。
```
gcloud run services describe SERVICE --format export > service.yaml
```
cpu 属性を更新します。
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/cpu-throttling: 'BOOLEAN'
      name: REVISION
```
次のように置き換えます。
- SERVICE は、Cloud Run サービスの名前に置き換えます。
- リクエスト処理中にのみ CPU を割り当てる場合は BOOLEAN を true に置き換えます。CPU を常時割り当てる場合は false に置き換えます。
- REVISION を新しいリビジョン名に置き換えるか、削除（存在する場合）します。新しいリビジョン名を指定する場合は、次の条件を満たす必要があります。
  - SERVICE- で始まる
  - 小文字、数字、- のみが使用されている
  - 末尾が - ではない
  - 63 文字以内である
次のコマンドを使用して、サービスを作成または更新します。
```
gcloud run services replace service.yaml
```

Terraform

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

Terraform 構成の template.containers.resources の google_cloud_run_v2_service リソースに次の内容を追加します。

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-cpu-allocation"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        # If true, garbage-collect CPU when once a request finishes
        cpu_idle = false
      }
    }
  }
}

CPU 割り当て設定を表示する

Cloud Run サービスの現在の CPU 割り当て設定を表示するには:

コンソール

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

Cloud Run に移動
目的のサービスをクリックして、[サービスの詳細] ページを開きます。
[変更内容] タブをクリックします。
右側の詳細パネルの [コンテナ] タブに、CPU 割り当て設定が表示されます。

gcloud

次のコマンドを使用します。
```
gcloud run services describe SERVICE
```
返された構成で、CPU 割り当ての設定を見つけます。

CPU の割り当て（サービス）

料金への影響

適切な CPU 割り当てを選択する方法

トラフィック パターンに関する考慮事項

バックグラウンド実行に関する考慮事項

費用に関する考慮事項

自動スケーリングに関する考慮事項

必要なロール

CPU 割り当ての設定と更新

コンソール

gcloud

YAML

Terraform

CPU 割り当て設定を表示する

コンソール

gcloud

トラフィックパターンに関する考慮事項