Infrastructure Manager（Infra Manager）を使用するには、Terraform に精通している必要があります。Terraform の詳細については、HashiCorp の Terraform とはをご覧ください。
Infra Manager は、Terraform 構成で定義されたインフラストラクチャ リソースと構成をデプロイします。これらの構成は複数のファイルとディレクトリで構成できますが、エントリポイントは Terraform ルート モジュールである必要があります。
Infra Manager では、Terraform 構成を「ブループリント」と呼びます。
Google Cloudでの Terraform の詳細については、 Google Cloudでの Terraform をご覧ください。
Google Cloudの Terraform モジュール
Google Cloud リソースをプロビジョニングする一連のモジュールについては、Google Cloud 用の Terraform ブループリントとモジュールをご覧ください。
Google Cloudに独自の Terraform モジュールを作成することもできます。詳細については、モジュールの作成をご覧ください。
サポートされている Terraform バージョン
Infra Manager は、次の Terraform バージョンをサポートしています。
- Terraform バージョン 1.2.3
- Terraform バージョン 1.3.10
- Terraform バージョン 1.4.7
- Terraform バージョン 1.5.7
フラグ --tf-version-constraint を使用して、Infrastructure Manager がデプロイメントの作成に使用する Terraform のバージョンを指定できます。
Terraform のバージョンを指定しない場合は、デフォルトで最新のサポート バージョンが使用されます。
デプロイメントを更新するときに、Terraform のバージョンを新しいバージョンの Terraform に変更できます。以前のサポート対象バージョンの Terraform に変更することはできません。
特定のデプロイまたはリビジョンの作成に使用された Terraform のバージョンを表示するには、デプロイの詳細を表示するとリビジョンの詳細を表示するをご覧ください。
Terraform 構成の制約
Infrastructure Manager を使用して Terraform 構成をデプロイするには、構成に次の制約があります。
- Terraform 構成値に個人情報や機密情報を含めないでください。詳細については、次のセクションの Terraform 構成値と機密データをご覧ください。
- 有効な Terraform ルート モジュールを指定する必要があります。Terraform のテンプレート化または生成はサポートされていません。
- 構成は、サポートされているバージョンの Terraform でアクチュエートできる必要があります。
- バックエンド ブロックは定義しないでください。
- プロビジョナーの使用はおすすめしません。可能であれば、別のソリューションを使用してください。プロビジョナーの詳細については、プロビジョナーは最後の手段ですをご覧ください。プロビジョナーを使用している場合、Infra Manager ランタイム環境はいつでも変更される可能性があることに注意してください。
Terraform 構成値と機密データ
Terraform 構成値に個人情報や機密情報を含めないでください。
プロバイダのドキュメント Google Cloud には、機密情報が含まれている可能性のある構成値が記載されています。
たとえば、リソース google_storage_bucket_object を使用すると、content 引数を使用して Cloud Storage オブジェクトを作成できます。この引数は、 Google Cloud プロバイダのドキュメントの google_storage_bucket_object ページで機密情報としてラベル付けされています。
これらのラベルは、Terraform 構成を作成する際や、使用前に既存の Terraform 構成を確認する際に役立ちます。
Cloud サービスの提供と管理中に収集または生成された個人情報の処理方法については、Google Cloud プライバシーに関するお知らせをご覧ください。 Google Cloud
次のステップ
- 詳しくは、Infrastructure Manager をご覧ください。
- デプロイを作成する。
- デプロイメントを更新する。
- デプロイの状態を表示する。
- デプロイメントを削除する。