用途:当仓库已用 Terraform 管理 Konnect,或用户明确要求 HCL、Terraform import、plan/apply 时,用官方 kong/konnect provider 编写与维护 Konnect 资源,并保留仓库既有的模块、状态与 CI 约定。
主要能力:优先使用共享 kong-konnect MCP 服务器检查实时 Konnect 状态;默认使用官方 kong/konnect provider,仅在明确需要时例外使用 kong/konnect-beta;支持导入、moved 块与资源收养,避免重建已有资源;按需加载 provider 选择、导入与收养、模块边界、Konnect 内 Gateway 实体、provider schema 调试等参考文件。
使用方式:先确认 terraform version、后端与工作区、Konnect 认证通过安全变量提供,并检查现有 provider 块、模块与变量命名;嵌套资源结构不清时以 terraform providers schema -json 为准;预览使用 terraform fmt -check(仅当仓库约定)、terraform validate、terraform plan,已有实时资源先 import;仅在用户明确要求时运行 terraform apply,并用 terraform state list、terraform state show <address> 或后续 plan 验证。
适用场景:Terraform 管理的 Konnect 平台资源、控制平面内 Gateway 实体,以及创建、更新、导入或漂移修正。
限制:不将 kongctl 或 decK 仓库转为 Terraform,除非用户要求迁移;不负责通用后端、状态锁或 provider 安装问题,除非直接阻塞 Konnect 资源工作;Gateway 文件式 GitOps 交给 deck-gateway,kongctl YAML 交给 kongctl-declarative;凭证不得写入 .tf 文件;apply 成功本身不构成证明。