Terraform：一份你能讲清楚的变更计划

在管理基础设施变更时，清晰度至关重要。在本文中，我们将探讨 Terraform 计划如何超越单纯的技术文档，成为关键的沟通工具。在技术快速迭代的当下，思考如何改进基础设施变更的审查与应用流程尤为重要。

症状：一份正确却无人能懂的计划

问题往往始于一句看似无害的话：“只不过是改几个资源而已。”然而，这种对细节的忽视可能会导致混乱和运维风险。有时，一份 Terraform 计划在技术上是正确的，但如果没有人能理解它，风险就会增加。对流程的信任会被削弱，进而可能引发严重后果。

一份优秀的计划应当回答的问题

一份优秀的 Terraform 计划应当通俗易懂，团队中的任何成员——即使是没有参与编写的人——都能读懂。它应包含以下内容：

• 意图： 正在新增什么能力，或正在修复什么问题？
• 范围： 哪些账号、区域、集群和环境会受到影响？
• 敏感变更： 是否有资源替换、权限变动或网络规则被销毁？
• 依赖关系： 在应用变更之前，必须有哪些服务处于运行状态？
• 恢复方案： 哪些内容可以回滚，哪些内容无法自动回滚？

建议的审查工作流

以下是可以遵循的审查工作流，即便是对于看似常规的变更也同样适用：

步骤 1：在可复现的环境中生成计划

确保记录好 commit、Terraform 版本、providers 以及 remote state。如果状态在审查期间发生变化，请重新生成一份新计划。切勿仅仅因为某个旧文件已经获得批准就去执行 apply。

步骤 2：区分预期变更与附带变更

识别并标记属于预期变更一部分的资源。排查任何附带变更，无论它是漂移（drift/偏差）、共享变量影响，还是 provider 不同的数据读取导致。

步骤 3：验证解释说明，而不只是检查语法

让其他人阅读摘要并解释：如果 provider 在执行中途返回错误会发生什么。如果他们无法理解流程，说明文档有所缺失。这种审查充当了 Terraform 与运维操作之间的一项小型契约测试。

步骤 4：商定观察窗口

明确需要观察哪些指标、观察多长时间以及何种阈值会叫停变更。确保团队中的每个人都知道在必要时由谁来叫停变更。

如何为回滚做好准备

可靠的回滚始于应用任何变更之前。将变更划分为以下几类：

• 可逆： 你可以直接回退到该 commit 并重新 apply，无需额外的迁移操作。
• 谨慎可逆： 需要恢复变量、规则或 secret。
• 不可逆： 修改数据、执行迁移或更改了外部依赖。

对于后两种情况，应在 runbook 中包含经过验证的备份或导出数据、决策负责人以及明确的中止条件。拥有清晰的回滚计划以应对出现问题时的状况至关重要。

Apply 前检查清单

在应用任何变更之前，请确保已满足以下各项：

• 计划是基于已审查的 commit 生成的。
• 已确认账号、区域和 workspace。
• 资源替换和权限变更已有明确说明。
• 漂移（drift）已得到排查，或已有指定的负责人接受。
• 具备最新的安全恢复点及恢复流程。
• 监控指标和日志观察已开启。
• 预留的窗口期不仅允许执行命令，还留有足够的时间等待观察结果。
• 团队知晓谁有权叫停变更。

如果这些复选框中有任何一项未被勾选，变更就应该先等一等。“在站会前完成 apply”的紧迫感，往往难以弥补因未审查依赖项而带来的风险。

结语

Terraform 会生成一份技术计划，但值班团队需要的是可执行的决策。良好的工作流能够将意图、diff 差异、依赖关系、观察指标和恢复方案串联起来。当团队中的任何人都能讲清发生了什么变更以及如何终止该流程时，这份计划才真正成为基础设施管理的有效工具。

优点

• 改善团队成员之间的沟通。
• 降低基础设施出错的风险。
• 使拟议的变更更易于理解。

缺点

• 可能需要更多时间来妥善记录变更。
• 需要额外的审查可能会减慢发布流程。

注意

本文仅供学习参考，所有占位符数值均须替换。在采纳相关论述前，务必对照原始来源进行核实。

常见问题解答

• 什么是 Terraform？ — Terraform 是一款基础设施即代码（Infrastructure as Code）工具，允许你管理和配置云资源。
• 为什么 Terraform 计划很重要？ — 清晰的计划有助于在向基础设施应用变更时避免混淆和错误。
• Terraform 中的回滚是什么？ — 回滚是指将已应用的基础设施变更恢复到其先前状态的过程。
• 如何改善团队沟通？ — 通过清晰记录变更并确保所有团队成员都能理解计划。
• Terraform 中的漂移（drift）是什么？ — 漂移是指资源的实际状态与 Terraform 中定义的状态之间的差异偏离。
• 一份优秀的 Terraform 计划应该包含什么？ — 它应当包含意图、范围、敏感变更、依赖关系以及恢复方案。

标签

#terraform #devops #sre #infrastructure #cloud #automation #rollback #communication #bestpractices #monitoring