SaaS ランタイムでは、ブループリントは、デプロイするインフラストラクチャとアプリケーションを定義するパッケージ化された Terraform 構成を指します。パッケージ化された Terraform 構成は、Artifact Registry に保存されている Open Container Initiative（OCI）イメージです。
このページで説明する内容は次のとおりです。
- SaaS Runtime を使用する場合の Terraform 構成の要件。
- Terraform 構成を SaaS ランタイムに提供する方法。
- SaaS Runtime が Terraform 構成をどのように使用するか。
このページは、Terraform に精通していることを前提としています。Terraform の詳細については、Terraform とはをご覧ください。
Terraform 構成を使用して OCI イメージを作成する方法については、ブループリントを作成してアップロードするをご覧ください。
ブループリントの要件
SaaS ランタイムは、Infrastructure Manager を使用して Terraform 構成を Google Cloudにデプロイします。要件と制約の詳細については、Terraform 構成の制約をご覧ください。
Terraform 構成を使用するために、SaaS Runtime は Terraform 構成のパッケージを使用します。このパッケージは、Artifact Registry に保存されている OCI（Open Container Initiative）イメージです。
Terraform 構成を含む OCI イメージを指定できます。それ以外の場合は、Terraform 構成を指定すると、SaaS ランタイムが OCI イメージを作成します。Terraform 構成を指定する方法の詳細については、次のセクションのブループリントを指定する方法をご覧ください。
ブループリントの Terraform 変数
Terraform 構成では、変数を使用してデプロイをカスタマイズできます。SaaS ランタイムには、これらの変数を管理するための柔軟な方法が用意されています。変数の管理をご覧ください。
ブループリントの提供方法
ブループリントは、Terraform 構成または Terraform 構成をパッケージ化した OCI イメージとして指定できます。
ブループリントは、次の方法で SaaS ランタイムに提供できます。
- 外部リポジトリに保存されている Terraform 構成。
- zip アーカイブに保存された Terraform 構成。
- Terraform 構成と Cloud Build を使用して、OCI イメージを自分でビルドし、Artifact Registry に push します。
- Terraform 構成と Cloud Build を使用して OCI イメージのビルドを自動化します。この自動化された方法は、CI/CD パイプラインに便利です。
SaaS ランタイムによるブループリントの使用方法
SaaS Runtime を使用すると、ブループリントは Docker 形式で Artifact Registry に保存されます。ブループリントは、Infrastructure Manager を使用して Google Cloud にデプロイされます。
Artifact Registry のリポジトリの詳細については、SaaS ランタイムのリポジトリを作成するをご覧ください。
ブループリントをアップロードする
ブループリントは、Terraform 構成または Terraform 構成をパッケージ化した OCI イメージとして指定できます。
ブループリントは、ユニットの種類を作成するときに SaaS ランタイムにアップロードします。ブループリントは、次のいずれかの方法で選択できます。
- Terraform 構成を zip アーカイブとしてアップロードします。
- 外部リポジトリをリンクします。
- Artifact Registry から既存のイメージを選択します。
詳細については、単位の種類を作成するをご覧ください。
ブループリントをプロビジョニングする
SaaS ランタイムは、ユニットを作成するときに、ブループリントで説明されているインフラストラクチャをプロビジョニングします。
SaaS ランタイムは、Infrastructure Manager を使用してインフラストラクチャをプロビジョニングします。Infrastructure Manager は、ワークフローの一部として Cloud Build を使用します。SaaS ランタイムがユニットを作成すると、デプロイのステータスに関する情報が次の 3 つのサービスすべてから取得できるようになります。
- SaaS ランタイム
- Infrastructure Manager
- Cloud Build
Infrastructure Manager が Terraform 構成をデプロイする方法の詳細については、Infrastructure Manager の概要をご覧ください。
バージョニングを制御する
SaaS Runtime は、Artifact Registry で OCI イメージをバージョン管理し、SaaS Runtime でリリースを使用して Artifact Registry の特定のバージョンのブループリントを指定することで、ブループリントのバージョン管理を制御します。
次のステップ
- SaaS ランタイムの使用を開始するには、クイックスタートをお試しください。
- Artifact Registry に、SaaS ランタイムのブループリントを保存するレジストリを作成します。
- ブループリントを作成してアップロードする。
- SaaS ランタイムの詳細については、SaaS ランタイムの概要をご覧ください。