Terraform バージョン管理ポリシー

Infrastructure Manager は、特定のバージョンの Terraform を使用して Google Cloud リソースをプロビジョニングして管理します。新機能へのアクセスを提供し、セキュリティの脆弱性に対処するため、Infra Manager は利用可能な 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 日 未定 未定 未定

表の列は次の内容を表します。

  • Terraform バージョン: Terraform バージョンの識別子。
  • 提供日: Infra Manager でバージョンが利用可能になる日付。
  • サポート終了日: バージョンのサポートが終了する予定の日付。この日以降に、このバージョンを使用してデプロイを作成または更新すると、警告が生成されます。

  • サポート終了日: バージョンのサポートが終了する日付。この期間は、非推奨から 180 日（またはそれ以上）後に終了します。

  • 自動移行先のバージョン: サポート終了日後にデプロイが自動的に移行されるバージョン（自動移行を有効にしている場合）。

サポートされているバージョンの現在のリストとライフサイクル日を確認するには、サポートされている Terraform のバージョンをご覧ください。

バージョンの非推奨化プロセス

Terraform バージョンは、サポート終了日を迎える前にサポート終了期間に入ります。

バージョンが非推奨になると、次のようになります。

  • 一般公開ドキュメントが、非推奨日とサポート終了日で更新されます。
  • 非推奨バージョンでデプロイまたはプレビューを作成または更新すると、警告が返されます。この警告は、バージョンが非推奨であることを示し、サポート終了日が含まれています。

バージョンのサポート終了日を過ぎると、そのバージョンは廃止済みとしてマークされます。廃止されたバージョンを使用して新しいデプロイを作成しようとすると、オペレーションはエラーで失敗します。廃止されたバージョンを参照する既存のデプロイを更新しようとすると、動作は組織の自動移行ポリシーによって異なります。

バージョンの提供プロセス

Terraform の新しい安定版が利用可能になると、サポートされているバージョンのリストに追加されます。新しい Terraform バージョンは、 Google Cloud コンソール、gcloud CLI、API で使用できるようになります。バージョン管理テーブルが新しいバージョンとその利用可能日を含むように更新され、Infra Manager のリリースノートが作成されます。

自動移行

サポートされていないバージョンを使用する既存のデプロイを更新すると、Infra Manager はデプロイをサポートされているバージョンに自動的に更新できます。この自動移行機能は、組織のポリシーで構成するオプトイン プロセスです。

自動移行を有効にしていない場合、サポートされていないバージョンを使用するデプロイに対して実行する更新オペレーションは失敗します。続行するには、デプロイ構成を手動で変更してサポートされているバージョンを指定し、オペレーションを再試行する必要があります。

自動移行ポリシーを構成する

Infra Manager の Terraform バージョンの自動移行ポリシーは、Google Cloud CLI を使用して構成できます。

自動移行ポリシーを有効にするには:

gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION

自動移行ポリシーを説明するには:

gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION

次のステップ