SuperAPI AI 工具集

deck-gateway

部署与运维

查看项目

更新于 10-15 23:47

技能介绍

用途:该技能用于生成、检查并应用 Kong Gateway 实体配置(decK),适用于 Gateway 实体管理与面向 Gateway 的 GitOps。不用于替代属于 kongctl 或 Terraform 的 Konnect 平台工作流。

主要能力:支持 deck gateway 的 validate、diff、sync、dump 及文件生成路径;可从 OpenAPI 文档派生 Gateway 实体;处理状态文件拆分、标签、include 边界与归属范围;在变更前安全检查实时状态。

使用方式:先确认 deck 已安装可运行(deck version),确认目标部署模型(自管理 Gateway 经 Admin API,或 Konnect 托管控制平面及相应认证参数),确认凭据已通过环境变量、配置文件或安全主机设置提供,切勿回显或提交密钥。编辑前检查现有文件结构,确认归属边界(状态文件、目录、include 路径或包装脚本,是否用标签限定归属,目标环境或控制平面)。预览阶段对正在编辑的文件、目录或 include 路径执行 validate,运行最小范围的 diff,仅在需要实时检查时使用限定范围的 dump,sync 前检查文件范围、include 边界、标签范围与意外删除。仅在用户明确要求变更时运行 deck gateway sync,并保持与已预览范围一致。变更后重跑相同范围的 deck gateway diff,确认无剩余预期变更。

适用场景:仓库已使用 decK、_format_version 或 deck gateway 命令,或用户明确要求 decK 时;从 API 规范派生 Gateway 实体时。

限制:decK 面向 Gateway 实体,不覆盖完整 Konnect 平台资源;Git 中的 decK 文件不证明实时控制平面与其一致;范围过宽的 sync 可能覆盖相邻实体变更;不适用于 DB-less 运行时加载、身份或团队管理、非 Gateway 的 Konnect 资源;若用户需要 HCL 加 Terraform 状态,应改用 terraform-kong-gateway、terraform-konnect 或 kongctl-declarative。