Application Design Center では、Google のスケーラブルなフルマネージド インフラストラクチャ上でステートレス コンテナを直接実行するように Cloud Run サービスを構成できます。特定のコンポーネント接続と構成パラメータに合わせてサービスをカスタマイズできます。構成パラメータは、GitHub の terraform-google-cloud-run Terraform モジュールに記載されています。
コンポーネントの接続
次の表に、Cloud Run サービスに接続できるコンポーネントと、その結果としてアプリケーションとその生成された Terraform コードに適用される更新を示します。
| 連結成分 | アプリケーションの更新 | 背景情報 |
|---|---|---|
| Secret Manager |
|
サービスのシークレットを構成する |
|
サービス間認証 | |
| AlloyDB for PostgreSQL |
|
Cloud Run から接続する |
| BigQuery |
|
BigQuery の概要 |
|
Bigtable の概要 | |
別の Cloud Run サービス |
|
Cloud Run とは |
|
Cloud Run から接続する | |
|
Cloud Run から接続する | |
|
Google Cloud サービスに接続する | |
|
Cloud Run を使用してグローバル外部アプリケーション ロードバランサを設定する | |
|
Cloud Run サービスから Redis インスタンスへの接続 | |
|
Memorystore for Redis Cluster インスタンスに接続する | |
|
Memorystore for Valkey インスタンスに接続する | |
|
Cloud Run で Pub/Sub を使用するチュートリアル | |
|
Cloud Run を使用してリージョン外部アプリケーション ロードバランサを設定する | |
|
転送ルールの概要 | |
|
Google Cloud サービスに接続する | |
|
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 のネットワーク上り(内向き)を制限する | |
メンバー |
サービスを呼び出すことができるユーザーとサービス アカウント。公開アクセスの場合は、「 |
サービスへのアクセスを管理する | |
| 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 を構成する |