SuperAPI AI 工具集

terraform-provider-docs

部署与运维

查看项目

更新于 10-16 07:18

技能介绍

用途:在编写或修改 Terraform 资源、数据源、Provider 配置前,先查阅官方 Registry 文档,避免因参数格式、枚举值或依赖关系猜测错误而反复出现 apply 失败。

主要能力:从代码中识别 Provider 与资源/数据源类型;按标准 URL 规则构造文档地址并抓取页面,重点阅读 Argument Reference(必填/可选、类型、合法取值、冲突、是否重建)、Attributes Reference、Import 说明与 Example Usage。附带资源:references/provider-urls.md 提供 10 个云厂商的 namespace/provider 映射;scripts/tf_doc_url.py 可由资源类型生成文档链接,例如 python scripts/tf_doc_url.py alicloud_forward_entry。

文档 URL 规则:资源为 https://registry.terraform.io/providers/{namespace}/{provider}/latest/docs/resources/{resource_name},数据源将 resources 换成 data-sources。资源名需去掉 Provider 前缀,如 alicloud_forward_entry → forward_entry。

适用场景:编写新资源、排查 InvalidParameter/InvalidValue/Malformed 类错误、修改参数、不确定格式(如端口范围、CIDR、协议名)、使用数据源、引用导出属性时,建议先查文档。

已知易错点:alicloud_forward_entry 端口范围分隔符用 / 而非 -(如 "1/65535");ip_protocol 仅接受 any、tcp、udp、forwardgroup(小写);ip_protocol=any 时 port 必须为 any;同一 EIP 端口大于 1024 的 DNAT 与 SNAT 冲突需 port_break=true;aws_security_group_rule 全协议用 "-1"。

限制:仅作为查文档流程指引,不包含各厂商全部资源细节;文档内容以官方 Registry 为准,资料未提供更多参数与厂商覆盖范围。