用途:为 Terraform 与 Terragrunt 的基础设施即代码工作流提供指导,从开发到生产部署。触发条件为用户提及 Terraform、Terragrunt、HCL 或 infrastructure as code。
主要能力:新建基础设施(可复用模块或环境专属配置)、状态管理与检查、标准 Terraform 工作流、故障排查、代码审查与质量检查,以及 Terragrunt 的依赖管理和多模块批量执行。提供脚本 scripts/init_module.py 与 scripts/validate_module.py,参考文档 references/best_practices.md、troubleshooting.md、cost_optimization.md,以及 CI/CD 模板(GitHub Actions、GitLab CI)。
使用方式:常用流程为 terraform init、terraform fmt -recursive、terraform validate、terraform plan -out=tfplan、terraform apply tfplan、terraform output。Terragrunt 用 terragrunt plan、terragrunt apply,或 terragrunt run-all plan 批量执行。状态操作可用 terraform state list/show/rm/mv 与 terraform import。模块脚手架运行 python3 scripts/init_module.py my-module-name,模块校验运行 python3 scripts/validate_module.py /path/to/module。质量检查可配合 tflint --module、checkov -d .、terraform-docs markdown。排错可设 export TF_LOG=DEBUG 并使用 -target 隔离问题;锁错误可 terraform force-unlock <lock-id>。
适用场景:AWS 等云上环境的模块化 IaC、多环境(dev/staging/prod)配置、Terragrunt 项目结构下的依赖编排与批量部署、CI/CD 流水线集成。
限制:具体支持的云平台范围、是否收费、版本要求、脚本与模板的完整内容,以及实际运行效果均暂未提供;使用前需自行核实环境兼容性与安全性。