Terraform 版本管理政策

Infrastructure Manager 使用特定版本的 Terraform 来预配和管理 Google Cloud 资源。为了提供对新功能的访问权限并解决安全漏洞，Infra Manager 会定期更新可用的 Terraform 版本。

本文档介绍了用于管理这些版本生命周期的政策。Terraform 版本管理政策为 Infra Manager 引入新版本和弃用版本提供了一个透明且可预测的流程。

政策的运作方式

Infrastructure 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 可以自动将该部署更新为受支持的版本。此自动迁移功能是一个选择性加入流程，您可以通过组织政策进行配置。

如果您未选择自动迁移，那么对使用不受支持版本的部署执行的任何更新操作都会失败。如需继续，您必须手动修改部署配置以指定受支持的版本，然后重试操作。

配置自动迁移政策

您可以使用 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

后续步骤