用途:在仓库已使用 Terraform 管理自托管 Kong Gateway 资源,或用户明确要求 Terraform 时,编写或修订由 Terraform 管理的自托管 Kong Gateway 实体,同时保留现有模块布局、provider 模型与 state 归属。
主要能力:负责 HCL 编写、导入优先采用、plan 审查,以及选定 Terraform 路径后的 Terraform 原生验证;使用官方 kong/kong-gateway provider 管理可通过 Admin API 访问的自托管 Gateway 资源;保留现有 Terraform 模块、变量、backend 设置与 workspace。
使用方式:先确认 Terraform 已安装可运行、目标 Admin API 端点与认证方式已存在,检查 provider 块、backend、workspace 与模块约定;嵌套资源结构不明确时以 terraform providers schema -json 为准。预览阶段运行仓库常规格式与校验检查、terraform validate、terraform plan;已存在的 Service、Route、插件等实体应先 import。仅在用户明确要求变更线上状态时运行 terraform apply,并保持目录、workspace 与变量输入与预览一致。apply 后用 terraform state list、terraform state show <address> 或后续 plan 验证。
适用场景:自托管 Gateway Admin API 配置的创建、更新、导入或漂移修正。
限制与交接:不用于 Konnect 平台资源(交给 terraform-konnect),不用于 decK 原生 GitOps 或导出/差异工作流(交给 deck-gateway),也不用于网关健康、插件行为或设计诊断。仓库已用 decK 时,除非任务就是迁移,否则不要切换为 Terraform。Admin API token 与密钥不得提交到文件。apply 成功本身不构成线上 Gateway 符合意图的证明。