Infrastructure Manager は、特定のバージョンの Terraform を使用して Google Cloud リソースをプロビジョニングして管理します。新機能へのアクセスを提供し、セキュリティの脆弱性に対処するため、インフラストラクチャ マネージャーは利用可能な Terraform バージョンを定期的に更新します。
このドキュメントでは、これらのバージョンのライフサイクルを管理するためのポリシーについて説明します。Terraform のバージョン管理ポリシーは、Infra Manager の新しいバージョンの導入とバージョンの非推奨化に関する透明性と予測可能性の高いプロセスを提供します。
ポリシーの仕組み
Infra Manager は、利用可能な Terraform バージョンとそのサポート ステータスのリストを公開しています。各バージョンは、提供、非推奨、サポート終了を含むライフサイクルを経て進行します。
次の表に、Terraform バージョンの非推奨情報を示します。
| Terraform バージョン | 料金ティア | 提供日 | サポート終了日 | サポート終了日 | バージョンに自動移行 |
|---|---|---|---|---|---|
1.2.3 |
無料枠 | 2023 年 8 月 21 日 | 2026 年 1 月 8 日 | 2026 年 2 月 8 日 | 1.5.7 |
1.3.10 |
無料枠 | 2024 年 3 月 14 日 | 未定 | 未定 | 未定 |
1.4.7 |
無料枠 | 2024 年 3 月 14 日 | 未定 | 未定 | 未定 |
1.5.7 |
無料枠 | 2024 年 3 月 14 日 | 未定 | 未定 | 未定 |
1.16.5 |
有料 | 2026 年 11 月 2 日 | 未定 | 未定 | 未定 |
表の列は次のとおりです。
Terraform バージョン: Terraform バージョンの識別子。
料金ティア: バージョンが無料枠（Infra Manager の管理料金なし）か有料（デプロイと管理の料金が発生します。Terraform バージョンのライセンスと料金をご覧ください）。
提供日: Infra Manager でバージョンが利用可能になる日付。
サポート終了日: バージョンのサポート終了が予定されている日付。この日付以降に、このバージョンを使用してデプロイを作成または更新すると、警告が生成されます。
サポート終了日: バージョンのサポートが終了する日付。この期間は、サポート終了から 180 日（またはそれ以上）後に終了します。
バージョンへの自動移行: サポート終了日以降にデプロイが自動的に移行されるバージョン（自動移行を有効にしている場合）。
サポートされているバージョンの現在のリストとライフサイクル日を確認するには、サポートされている Terraform のバージョンをご覧ください。
バージョンの非推奨化プロセス
Terraform バージョンが非推奨日になると、サポート終了日より前に非推奨期間に入ります。
バージョンが非推奨になると、次のようになります。
- 公開ドキュメントがサポート終了日とサポート終了日で更新されます。
- 非推奨のバージョンでデプロイまたはプレビューを作成または更新すると、警告が返されます。この警告は、バージョンが非推奨であることを示し、サポート終了日が含まれています。
バージョンのサポート終了日を過ぎると、そのバージョンは廃止済みとしてマークされます。廃止されたバージョンを使用して新しいデプロイを作成しようとすると、オペレーションはエラーで失敗します。廃止されたバージョンを参照する既存のデプロイを更新しようとすると、その動作は組織の自動移行ポリシーによって異なります。
バージョン提供のプロセス
Terraform の新しい安定版が利用可能になると、サポートされているバージョンのリストに追加されます。新しい Terraform バージョンは、 Google Cloud コンソール、gcloud CLI、API で使用できるようになります。バージョン管理テーブルが新しいバージョンとその提供開始日で更新され、Infra Manager のリリースノートが作成されます。
自動移行
サポートされていないバージョンを使用する既存のデプロイを更新すると、Infra Manager はデプロイをサポートされているバージョンに自動的に更新できます。この自動移行機能は、組織のポリシーで構成するオプトイン プロセスです。
自動移行を有効にしていない場合、サポートされていないバージョンを使用するデプロイに対して更新オペレーションを実行すると、失敗します。続行するには、デプロイ構成を手動で変更して、サポートされているバージョンを指定してから、オペレーションを再試行する必要があります。
自動移行ポリシーを構成する
Google Cloud CLI を使用して、Infra Manager で Terraform バージョンの自動移行ポリシーを構成できます。
自動移行ポリシーを有効にするには:
gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION
自動移行ポリシーを記述するには:
gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION
次のステップ
- サポートされているバージョンの現在のリストとライフサイクル日を確認するには、サポートされている Terraform のバージョンをご覧ください。