Terraform Cloud Run 触发器

为什么需要这个技能

在基础设施即代码实践中，Terraform Cloud 提供了远程状态管理和协作能力，但当团队希望将运行触发集成到 CI/CD 流水线时，手动登录控制台点击按钮的方式就显得笨拙。你需要的是：当代码推送到仓库时自动触发 plan，当合并到主分支时自动应用变更，同时还能以编程方式管理不同环境下的工作区变量。

这个技能通过 Terraform Cloud API v2 解决了这些问题，让你可以用脚本或流水线直接创建运行、获取计划输出、管理变量，而无需人工干预。

核心能力

运行创建与模式控制

通过 POST /api/v2/runs 端点创建工作区运行，支持两种执行模式：

• plan-only 模式：仅生成执行计划，不实际应用变更，适合在合并前审查
• auto-apply 模式：计划成功后自动应用，适合已通过审查的变更

这种区分让你可以在代码评审阶段先生成计划，确认无误后再触发应用。

计划输出流式获取

创建运行后，通过 /api/v2/plans/{id}/log 端点获取计划日志。这个流式接口允许你实时查看 Terraform 的执行计划，包括将要创建、更新或销毁的资源。对于 CI/CD 流水线来说，这意味着你可以将计划输出展示给团队成员或作为审查记录存档。

工作区变量管理

通过 /api/v2/workspaces/{id}/vars 端点管理工作区变量集合。Terraform Cloud 允许为每个工作区配置环境变量和敏感值，这个技能让你可以用脚本批量创建、更新或删除这些变量，而无需在控制台中手动操作。

适用场景与注意事项

这个技能适合以下场景：

• CI/CD 集成：当代码推送时自动触发 plan，合并时自动 apply，减少人工操作
• 多环境管理：为开发、测试、生产等不同工作区配置不同的变量集合
• 审计与合规：记录每次运行的计划输出，用于后续审查或合规要求

需要注意的是：

• 需要有效的 Terraform Cloud API 令牌，且具有对应工作区的权限
• API v2 有速率限制，高频触发时需要考虑节流
• 自动应用模式需要谨慎使用，建议先在测试环境验证
• 变量管理涉及敏感信息，确保使用安全的认证方式