Cloud Run サービスを構成する

Application Design Center では、Google のスケーラブルなフルマネージド インフラストラクチャ上でステートレス コンテナを直接実行するように Cloud Run サービスを構成できます。特定のコンポーネント接続と構成パラメータに合わせてサービスをカスタマイズできます。構成パラメータは、GitHub の terraform-google-cloud-run Terraform モジュールに記載されています。

コンポーネントの接続

次の表に、Cloud Run サービスに接続できるコンポーネントと、その結果としてアプリケーションとその生成された Terraform コードに適用される更新を示します。

連結成分 アプリケーションの更新 背景情報
Secret Manager
  • Cloud Run サービスはシークレット データを参照できます。
  • Secret Manager の [シークレット データ] フィールドは、Cloud Run の env_secret_vars フィールドによって参照されます。
  • Cloud Run サービス アカウントに roles/secretmanager.secretAccessor ロールが付与されている。
サービスのシークレットを構成する

サービス アカウント

  • Cloud Run サービスは、サービス アカウントをサービス ID として使用します。
  • サービス アカウントに roles/run.invoker ロールが付与されている。
  • サービス アカウントのメールアドレスと Identity and Access Management(IAM)の情報が Cloud Run の環境変数に追加されます。
サービス間認証
AlloyDB for PostgreSQL
  • Cloud Run サービスは AlloyDB インスタンスに接続できます。
  • AlloyDB リソースのメタデータが Cloud Run の環境変数に追加されます。
  • Cloud Run サービス アカウントに roles/alloydb.admin ロールが付与されている。
Cloud Run から接続する
BigQuery
  • Cloud Run サービスは BigQuery データセットを操作できます。
  • BigQuery リソースのメタデータが Cloud Run の環境変数に追加されます。
  • Cloud Run サービス アカウントに roles/bigquery.dataEditor ロールが付与されている。
BigQuery の概要

Bigtable

  • Cloud Run サービスは、Bigtable インスタンスで管理機能を実行できます。
  • Bigtable リソースのメタデータ情報が Cloud Run 環境変数に追加されます。
  • Cloud Run サービス アカウントに roles/bigtable.admin ロールが付与されている。
Bigtable の概要

別の Cloud Run サービス

  • ソース Cloud Run サービスは、宛先の Cloud Run サービスにトラフィックを送信できます。
  • 送信元 Cloud Run サービスには、環境変数に宛先 Cloud Run サービス URI が含まれています。
Cloud Run とは

Cloud SQL(MySQL)

  • Cloud Run サービスは、Cloud SQL(MySQL)インスタンスからデータを読み取り、書き込むことができます。
  • Cloud SQL 接続メタデータが Cloud Run サービスに追加されます。
  • roles/cloudsql.instanceUser ロールと roles/cloudsql.client ロールが Cloud Run サービス アカウントに付与されている。
  • Cloud Run サービス アカウントが IAM ユーザーとして Cloud SQL インスタンスに追加されている。
Cloud Run から接続する

Cloud SQL(PostgreSQL)

  • Cloud Run サービスは、Cloud SQL(PostgreSQL)インスタンスからデータを読み取り、インスタンスにデータを書き込むことができます。
  • Cloud SQL 接続メタデータが Cloud Run サービスに追加されます。
  • roles/cloudsql.instanceUser ロールと roles/cloudsql.client ロールが Cloud Run サービス アカウントに付与されている。
  • Cloud Run サービス アカウントが IAM ユーザーとして Cloud SQL インスタンスに追加されている。
Cloud Run から接続する

Cloud Storage

  • Cloud Run サービスは、Cloud Storage バケット内のオブジェクトを管理できます。
  • Cloud Run サービス アカウントの IAM 情報が Cloud Storage バケットに追加されます。
  • Cloud Run サービス アカウントに roles/storage.objectAdmin ロールが付与されている。
Google Cloud サービスに接続する

グローバル Cloud Load Balancing バックエンド

  • ロードバランサは、受信トラフィックを Cloud Run サービスに分散できます。
  • Cloud Run サービスは、Cloud Load Balancing サーバーレス NEG バックエンド構成にバックエンド エンドポイントとして追加されます。
Cloud Run を使用してグローバル外部アプリケーション ロードバランサを設定する

Memorystore for Redis

  • Cloud Run サービスは、Memorystore for Redis インスタンスにデータをキャッシュできます。
  • Memorystore for Redis の接続情報が Cloud Run の環境変数に追加されます。
  • Cloud Run サービス アカウントに roles/redis.editor ロールが付与されている。
Cloud Run サービスから Redis インスタンスへの接続

Memorystore for Redis Cluster

  • Cloud Run サービスは、Memorystore for Redis Cluster インスタンスにデータをキャッシュに保存できます。
  • Memorystore for Redis Cluster の接続情報が Cloud Run の環境変数に追加されます。
  • App Design Center は、Cloud Run サービス アカウントに roles/redis.dbConnectionUser ロールを付与します。
Memorystore for Redis Cluster インスタンスに接続する

Memorystore for Valkey

  • Cloud Run サービスは、Memorystore for Valkey インスタンスにデータをキャッシュに保存できます。
  • App Design Center は、Memorystore for Valkey の接続情報を Cloud Run の環境変数に追加します。
  • App Design Center は、Cloud Run サービス アカウントに roles/memorystore.dbConnectionUser ロールを付与します。
Memorystore for Valkey インスタンスに接続する

Pub/Sub

  • Cloud Run サービスは、メッセージを受信したり、Pub/Sub トピックにパブリッシュしたりできます。
  • Pub/Sub トピック ID が Cloud Run の環境変数に追加されます。
  • roles/pubsub.publisher ロールと roles/pubsub.subscriber ロールが Cloud Run サービス アカウントに付与されている。
  • Cloud Run サービスが Pub/Sub の push サブスクリプション フィールドと pull サブスクリプション フィールドに追加されます。
Cloud Run で Pub/Sub を使用するチュートリアル

リージョン Cloud Load Balancing バックエンド

  • ロードバランサは、受信トラフィックを Cloud Run サービスに分散できます。
  • Cloud Run サービスは、Cloud Load Balancing サーバーレス NEG バックエンド構成にバックエンド エンドポイントとして追加されます。
Cloud Run を使用してリージョン外部アプリケーション ロードバランサを設定する

リージョン Cloud Load Balancing フロントエンド

  • ロードバランサの HTTP および HTTPS IP アドレスは、Cloud Run コンテナで実行されているアプリケーションで使用できます。
  • Cloud Load Balancing のアドレス メタデータが Cloud Run の環境変数に追加されます。
転送ルールの概要

Spanner

  • Cloud Run サービスは Spanner インスタンスを管理できる。
  • Spanner 接続の詳細が Cloud Run の環境変数に追加されます。
  • Cloud Run サービス アカウントに roles/spanner.databaseAdmin ロールが付与されている。
  • Cloud Run サービス アカウントの IAM 情報が Spanner インスタンスに追加されます。
Google Cloud サービスに接続する

Vertex AI

  • Cloud Run サービスは Vertex AI サービスとやり取りできます。
  • Cloud Run サービス アカウントに roles/aiplatform.user ロールが付与されている。
Cloud Run で AI アプリとエージェントをホストする

必須の構成パラメータ

テンプレートに Cloud Run コンポーネントが含まれている場合は、デプロイする前に次のパラメータを構成する必要があります。

パラメータ名 説明と制約 背景情報

プロジェクト ID

Cloud Run リソースをデプロイするプロジェクト。

コンポーネントを構成する

リージョン

Cloud Run サービスのデプロイ ロケーション。

Cloud Run のロケーション

サービス名

name Cloud Run サービス

オプションの構成パラメータ

次のパラメータは省略可能です。詳細パラメータを表示するには、[構成] 領域で [詳細フィールドを表示] を選択します。

機能 パラメータ名 説明と制約情報 背景情報
コンテナ

コンテナ名

name コンテナのビルド
コンテナ

コンテナ イメージ

image Cloud Run へのコンテナ イメージのデプロイ
コンテナ

作業ディレクトリ

コンテナの作業ディレクトリ。指定しない場合、コンテナ ランタイムのデフォルトが使用されます。これはコンテナ イメージで構成されている場合があります。

workingDir
コンテナ

コンテナに依存

dependsOn[] サイドカー デプロイでコンテナの起動順序を構成する
コンテナ

コンテナ引数

args[] サービスのコンテナを構成する
コンテナ

コンテナ コマンド

command サービスのコンテナを構成する
コンテナ: 環境変数

Key(キー)

name サービスの環境変数
コンテナ: 環境変数

値

value サービスの環境変数
コンテナ: 環境シークレット変数

Key(キー)

EnvVarSource Cloud Run がシークレットにアクセスできるようにする
コンテナ: 環境シークレット変数

Secret

Secret Cloud Run がシークレットにアクセスできるようにする
コンテナ: 環境シークレット変数

バージョン

version Cloud Run がシークレットにアクセスできるようにする
コンテナ: ボリューム マウント

名前

name Cloud Run から接続する
コンテナ: ボリューム マウント

マウントパス

mountPath Cloud Run から接続する
コンテナ: ポート

名前

name サービスに HTTP/2 を使用する
コンテナ: ポート

コンテナポート

containerPort サービスに HTTP/2 を使用する
コンテナ: リソース

CPU

limits サービスの CPU 上限を構成する
コンテナ: リソース

メモリ

limits サービスのメモリ上限を構成する
コンテナ: リソース

CPU アイドル

リクエスト中にのみ CPU を割り当てるかどうか。

cpuIdle
コンテナ: リソース

起動時の CPU ブースト

startupCPUBoost 起動時の CPU ブーストを設定する
コンテナ: 起動プローブ

失敗のしきい値

failureThreshold サービスにコンテナのヘルスチェックを構成する
コンテナ: startupProbe

Initial Delay Seconds

initialDelaySeconds 起動プローブを構成する
コンテナ: 起動プローブ

タイムアウト(秒)

timeoutSeconds 起動プローブを構成する
コンテナ: 起動プローブ

期間(秒)

periodSeconds 起動プローブを構成する
コンテナ: 起動プローブ

HTTP Get パス

path 起動プローブを構成する
コンテナ: 起動プローブ

HTTP Get ポート

ポート 起動プローブを構成する
コンテナ: 起動プローブ

HTTP ヘッダー名

name 起動プローブを構成する
コンテナ: 起動プローブ

HTTP ヘッダーの値

value 起動プローブを構成する
コンテナ: 起動プローブ

TCP ソケットポート

ポート デフォルトの TCP 起動プローブ
コンテナ: startupProbe

GRPC ポート

ポート 起動プローブを構成する
コンテナ: 起動プローブ

GRPC サービス

service 起動プローブを構成する
コンテナ

Liveness プローブ

livenessProbe ユースケース

説明

description サービスの説明を設定する

サービス アカウントを作成する

Cloud Run サービスの新しいサービス アカウントを作成する。

サービスのサービス ID を構成する

サービス アカウントのプロジェクト ロール

新しく作成したサービス アカウントに付与するロール。[サービス アカウントを作成] を有効にし、[サービス アカウント] には何も入力しません。

サービスのサービス ID を構成する

上り(内向き)

IngressTraffic Cloud Run のネットワーク上り(内向き)を制限する

メンバー

サービスを呼び出すことができるユーザーとサービス アカウント。公開アクセスの場合は、「allUsers」と入力します。ログインした Google ユーザーによるアクセスを許可するには、allAuthenticatedUsers を入力するか、特定のユーザーとサービス アカウントのリストを入力します。詳細については、メンバーをご覧ください。

サービスへのアクセスを管理する
VPC アクセス

コネクタ

コネクタ コネクタを使用する VPC
VPC アクセス 下り(外向き) 下り(外向き) 下り(外向き)サービス トラフィックを制御する
VPC アクセス: ネットワーク インターフェース ネットワーク network サービスをデプロイする
VPC アクセス: ネットワーク インターフェース サブネットワーク サブネットワーク サービスをデプロイする
VPC アクセス: ネットワーク インターフェース タグ タグ サービスをデプロイする

Cloud Run の削除からの保護

Terraform が Cloud Run のジョブとサービスを破棄または再作成しないようにします。

deletion_protection

Prometheus サイドカーを有効にする

Cloud Run サービスで Prometheus サイドカーを有効にします。

Prometheus サイドカーを使用して Prometheus 指標を書き込む
ボリューム

名前

name インメモリ ボリュームを構成する
Volumes: Secret Secret Secret Cloud Run がシークレットにアクセスできるようにする
Volumes: Secret デフォルト モード defaultMode Cloud Run がシークレットにアクセスできるようにする
Volumes: Secret [パス] path Cloud Run がシークレットにアクセスできるようにする
Volumes: Secret バージョン version Cloud Run がシークレットにアクセスできるようにする
Volumes: Secret Mode モード Cloud Run がシークレットにアクセスできるようにする
ボリューム: Cloud SQL インスタンス インスタンス instances[] Cloud Run から接続する
Volumes: Empty Dir 中 medium サービスのインメモリ ボリュームのマウントを構成する
Volumes: Empty Dir サイズ制限 sizeLimit サービスのインメモリ ボリュームのマウントを構成する
Volumes: GCS バケット バケット サービスの Cloud Storage ボリュームのマウントの構成
Volumes: GCS 読み取り専用 readOnly サービスの Cloud Storage ボリュームのマウントの構成
Volumes: NFS サーバー server サービスの NFS ボリューム マウントを構成する
Volumes: NFS [パス] path サービスの NFS ボリューム マウントを構成する
Volumes: NFS 読み取り専用 readOnly サービスの NFS ボリューム マウントを構成する
サービスのスケーリング

最小インスタンス数

minInstanceCount サービスの最小インスタンス数を設定する

リビジョン

リビジョン Cloud Run サービスのリビジョン
テンプレートのスケーリング

最小インスタンス数

minInstanceCount サービスの最小インスタンス数を設定する
テンプレートのスケーリング 最大インスタンス数 maxInstanceCount 最大インスタンス数について

暗号鍵

encryptionKey 顧客管理の暗号鍵の使用

インスタンスの最大同時リクエスト数

maxInstanceRequestConcurrency サービスの最大同時リクエスト数

セッション アフィニティ

sessionAffinity サービスのセッション アフィニティを設定する

実行環境

executionEnvironment サービス実行環境について
トラフィック

型

type ロールバック、段階的なロールアウト、トラフィックの移行
トラフィック Percent パーセント ロールバック、段階的なロールアウト、トラフィックの移行
トラフィック リビジョン リビジョン ロールバック、段階的なロールアウト、トラフィックの移行
トラフィック タグ tag ロールバック、段階的なロールアウト、トラフィックの移行
サービスラベル

Key(キー)

labels サービスのラベルを構成する
サービスラベル 値 labels サービスのラベルを構成する
サービス アノテーション

Key(キー)

annotations annotations
サービス アノテーション 値 annotations annotations
クライアント

名前

API クライアントの任意の識別子。

client
クライアント バージョン

API クライアント バージョンの任意の識別子。

clientVersion

リリース ステージ

LaunchStage プロダクトのリリース ステージ

カスタム オーディエンス

customAudience サービスにカスタム オーディエンスを設定する
Binary Authorization

ブレークグラスの理由

breakglassJustification ブレークグラスを使用する
Binary Authorization デフォルトを使用 useDefault Binary Authorization を使用する
テンプレート ラベル

Key(キー)

labels サービスのラベルを構成する
テンプレート ラベル 値 labels サービスのラベルを構成する
テンプレート アノテーション

Key(キー)

annotations annotations
テンプレート アノテーション 値 annotations annotations

タイムアウト

timeout サービスのリクエスト タイムアウトを設定する

サービス アカウント

serviceAccount サービスのサービス ID を構成する