SuperAPI AI 工具集

terraform-tasks

部署与运维

查看项目

更新于 10-15 12:03

技能介绍

Terraform Tasks 是一个用于自主执行 Terraform 相关任务的技能,强调对常见工作流与流水线步骤的覆盖,并具备较全面的 Provider 知识与平台感知能力。

用途 该技能面向 Terraform 基础设施即代码的日常与复杂任务,可在较少人工干预下完成从代码生成到排错、安全加固、架构调整和迁移的多种工作。

主要能力

  1. 基础设施代码生成:根据用户上下文确定 Provider 与版本,必要时检索最新文档,生成包含 Provider 版本约束、资源配置、带校验的变量、输出和安全最佳实践的完整配置。示例任务包括创建带私有终结点和客户管理密钥的 Azure 存储账户、生成三层架构与 NAT 网关的 AWS VPC、构建带 Workload Identity 和节点池的 GCP GKE 集群。
  2. 版本管理:检查当前版本,研究变更日志与破坏性变更,提出升级路径,生成迁移代码并提供测试策略。示例包括 AzureRM Provider 2.x 升级到 3.x、Terraform 0.12 迁移到 1.x、更新所有 Provider 到最新兼容版本。
  3. 调试与排错:收集诊断信息,分析错误与日志,定位根因,给出平台相关解决方案与预防措施。示例包括 Windows 上状态锁超时、Azure DevOps 流水线中 Provider 认证失败、模块结构循环依赖。
  4. 安全扫描与修复:运行 tfsec、Checkov 等扫描器,分析结果并按优先级生成修复,解释安全影响。示例包括修复所有 HIGH 级别问题、确保 S3 桶启用加密、实现符合安全最佳实践的 Azure 存储账户。
  5. 架构评审:分析现有结构,识别反模式,提出改进与重构计划,并以 ADR 记录决策。示例包括 500+ 资源的状态管理策略评审、多区域高可用架构设计、将单体状态重构为分层方案。
  6. CI/CD 流水线生成:确定 CI/CD 平台与环境策略,生成流水线配置,包含安全扫描、审批门禁与漂移检测。示例包括 Azure DevOps 多阶段部署、带 OIDC 认证的 GitHub Actions、使用 Terraform Cloud 后端的 GitLab CI。
  7. 模块开发:设计模块接口,按最佳实践实现,添加变量校验,生成文档与示例,并设置测试。示例包括 hub-spoke 模式的 Azure 网络模块、带自动扩缩与 ALB 的 AWS ECS 模块、支持自定义域名的 GCP Cloud Run 模块。
  8. 迁移任务:盘点现有资源,生成导入命令与匹配的 Terraform 代码,验证配置,测试导入流程并规划切换策略。示例包括将现有 Azure 资源导入 Terraform、从 CloudFormation 迁移到 Terraform、将 ARM 模板转换为 Terraform HCL。

使用方式 该技能以自主方式运行:自动检测 Terraform 与 Provider 版本、识别平台(Windows/Linux/macOS)与 CI/CD 环境、检查现有配置;通过 WebSearch 查找最新文档、变更日志与最佳实践;生成完整可运行代码(如 main.tf、variables.tf、outputs.tf 等)并附注释;对生成代码运行 terraform fmt、校验语法、检查安全问题;解释架构决策、记录用法示例与版本兼容性、提供排错提示。遇到问题时按“收集上下文—研究—平台感知—提供多种方案—预防建议”的流程处理。

平台相关注意事项 Windows 上使用 Edit 或 Write 工具时,文件路径必须使用反斜杠(如 D:\repos\project\file.tsx),而非正斜杠;同时需考虑 PowerShell 语法、行尾、执行策略与凭据管理。Linux/macOS 需考虑 Bash 语法、文件权限、包管理器与环境变量。CI/CD 环境需考虑流水线语法、代理能力、认证方式与制品处理。

文档约定 除非用户明确要求,不创建新的文档文件;优先更新现有 README.md;保持仓库根目录整洁,仅保留 README.md;文档应简洁、直接、专业。

质量要求 生成的 Terraform 代码需格式规范(terraform fmt)、通过校验(terraform validate)、包含安全最佳实践、具备完善的变量校验与有意义的描述、遵循命名约定、版本兼容、包含用法示例与正确的输出定义。

Provider 覆盖 支持 Azure(AzureRM、AzAPI、服务终结点与私有终结点、托管标识、RBAC 与策略)、AWS(各服务、IAM 角色与策略、VPC 网络、S3 后端、跨账户部署)、Google Cloud(各服务、IAM 与服务账号、VPC 与网络、GCS 后端、组织与文件夹策略),以及 Kubernetes、Helm、Datadog、PagerDuty、GitHub、GitLab、HashiCorp Vault 等社区 Provider。

与 terraform-expert Agent 的集成 该技能与 terraform-expert agent 协同工作:Agent 提供战略指导,技能执行战术任务,Agent 校验技能输出,技能向 Agent 汇报。

适用场景 适合需要自主执行 Terraform 任务、并希望获得较全面 Provider 知识与平台感知的场合,例如生成云资源代码、升级版本、排查故障、安全加固、评审架构、生成流水线、开发模块和迁移现有基础设施。

限制 资料未提供该技能的收费、价格、具体平台支持范围、效果保证或安装命令等信息,暂未提供。