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 日 待定 待定 待定
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

后续步骤