API 网关落地指南(Kong)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-api-gateway-deployment-guide。
技能介绍
问题在哪
把 Kong 当作 API 网关落地时,常见问题不是「会不会装插件」,而是:路由与上游怎么划界、鉴权限流放哪一层、多环境配置如何对齐,以及上线前后评审与排错缺乏统一清单。团队各自摸索时,方案文档缺背景与风险,PR 里安全与边界问题容易被风格讨论淹没。
技能如何帮你落地
本技能把通用工程能力接到 API 网关落地(Kong) 场景:用触发词进入对应模式,按结构化模板出交付物。
- 技术方案设计:输入需求与约束(流量规模、是否多集群、现有认证体系),产出含背景、目标、选型对比与风险的方案骨架。
- 代码评审:对网关相关
diff/PR 按正确性、安全、可维护性分级,输出阻断/建议/可选意见及理由。 - 调试排错:结合报错、日志与上下文,走「稳定复现 → 隔离变量 → 看证据 → 假设验证」的定位树。
- 架构权衡:在 Kong 与替代方案或其它网关形态之间,按场景与规模给利弊、适用边界与成本表。
- API 设计 / 工程规范:围绕路由、契约、错误码与反模式清单,对齐 RESTful 与网关侧最佳实践。
核心工作流在 SKILL 中固定为两套:代码评审(先意图与正确性,再安全)与 线上排错(先复现再改代码)。听到「评审」「方案」「又报错了」「用 A 还是 B」等触发词即可路由到对应能力,多个诉求可组合使用。
边界与注意点
技能提供方法论、模板与检查清单,不替代你对生产变更的最终决策;涉及密钥或凭证仅给脱敏示例。不接入付费服务或外部账号,输出需你结合自家环境与合规要求微调。
使用场景
- 新服务要上 Kong:要写一份含鉴权、路由拆分与多环境差异的技术方案
- 网关插件或路由规则 PR 待合并:需要按安全与边界条件做分级评审清单
- 生产环境 Kong 返回 502/超时:有日志片段,要按复现与隔离步骤定位上游或配置问题
- 在 Kong 与 Nginx/云厂商网关之间选型:要按 QPS 与团队运维能力列利弊表
适合人员
- 后端工程师:负责 Kong 路由与上游配置,要在上线前补齐评审与安全检查项
- DevOps / 平台同学:维护多集群 Kong,需要排错工作流与配置对齐的模板
- 技术负责人:网关层架构未定,要在方案里写清选型理由、风险与回滚路径
- 全栈或小团队主程:既要定 REST 契约又要写网关侧规范,希望用同一套清单减少联调扯皮