Terraform 版本管理政策

Infrastructure Manager 會使用特定版本的 Terraform 佈建及管理 Google Cloud 資源。為提供新功能並解決安全漏洞，Infra Manager 會定期更新可用的 Terraform 版本。

本文說明管理這些版本生命週期的政策。 Terraform 版本管理政策提供透明且可預測的程序，方便您瞭解 Infrastructure 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 版本的 ID。
  • 發布日期：版本在 Infra Manager 中可用的日期。
  • 淘汰日期：預計淘汰版本的日期。在這個日期之後，使用該版本建立或更新部署作業時，系統會顯示警告。

  • 終止支援日期：不再支援該版本的日期。 這段期間會在淘汰後 180 天 (或更久) 結束。

  • 自動遷移至版本：支援期限結束後，部署作業會自動遷移至這個版本 (如果您已選擇自動遷移)。

如要查看目前支援的版本清單和生命週期日期，請參閱「支援的 Terraform 版本」。

版本淘汰程序

Terraform 版本達到淘汰日期後，會進入淘汰期，然後才會停止支援。

版本淘汰後：

  • 公開文件會更新淘汰日期和支援終止日期。
  • 使用已淘汰版本建立或更新部署作業或預覽時，系統會傳回警告。這項警告會說明該版本已遭淘汰，並列出支援終止日期。

版本終止支援日期過後，系統會將該版本標示為過時。如果嘗試使用舊版建立新的部署作業，作業會失敗並顯示錯誤。如果您嘗試更新參照舊版項目的現有部署作業，系統的行為取決於貴機構的自動遷移政策。

版本發布程序

如果推出新的 Terraform 穩定版，就會新增至支援版本清單。新版 Terraform 可在 Google Cloud 控制台、gcloud CLI 和 API 中使用。版本管理表格會更新為新版本及其推出日期，並建立 Infra Manager 版本資訊。

自動遷移

更新使用不支援版本的現有部署作業時，Infra Manager 可以自動將部署作業更新為支援的版本。這項自動遷移功能是選擇加入程序，您可透過機構政策進行設定。

如果您未選擇自動遷移，對使用不支援版本的部署作業執行任何更新作業都會失敗。如要繼續，請手動修改部署設定，指定支援的版本，然後重試作業。

設定自動遷移政策

您可以使用 Google Cloud CLI，在 Infrastructure Manager 上設定 Terraform 版本的自動遷移政策。

如要啟用自動遷移政策，請按照下列步驟操作：

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

如要說明自動遷移政策，請執行下列操作：

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

後續步驟