第1章 全面了解Kong网关
依据孔庆雍《Kong网关:入门、实战与进阶》完整目录:从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目
第1章 全面了解Kong网关
本课程对应孔庆雍著《Kong网关:入门、实战与进阶》,机械工业出版社2021年9月出版,472页,ISBN 9787111689478。权威目录为4篇、16章、附录A至D。作者配套源码与第1章示例固定kong:2.0.5,因此课程以Kong 2.0.5为行为边界。
全书正式分母为16章与4个附录,共20个正式单元、280个唯一章/附录/节节点;另设学习地图和总复习,共22页。后来的Kong Gateway路由表达式、新插件、Konnect、现代控制面或AI Gateway只能作为版本差异,不能替代原书内容。本页逐项覆盖20个目录节点,交付网关职责表、组件拓扑、三平台安装记录、Web应用路由与静态资源代理验收。
学习目标
- 能解释“第1章 全面了解Kong网关”的20个目录节点,并绘制客户端、Kong、插件、上游与外部依赖的责任边界。
- 能比较基线、压力、配置变化、节点故障和恢复轨迹,判断路由、插件、缓存、重试与业务完成点。
- 能设计并复现网关职责表、组件拓扑、三平台安装记录、Web应用路由与静态资源代理验收,用配置、请求、日志、指标与最终状态支持结论。
- 能分析“只证明8000端口能返回响应,却没有验证路由来源、Admin API暴露面、静态资源边界和版本”为何失败,并写出停止、恢复、回退与独立交接条件。
从一条经过网关的请求开始
先预测:请求携带Host、path、method、headers和协议进入Kong后会命中哪个Route,关联哪个Service,哪些插件按优先级进入rewrite、access、header_filter、body_filter与log阶段,Upstream怎样选择Target,最终响应和日志包含什么。观察前必须写下预测,再用真实轨迹纠正模型。
Kong 2.0.5的正确性不是“端口能通”。控制面接受配置、worker取得配置、路由匹配、插件执行、上游完成、客户端收到响应和业务状态落定是不同检查点。超时与重试还可能让一次客户端请求触发多次上游操作,非幂等操作必须单独验证。
核心词汇与版本边界
↡网关层是第1章 全面了解Kong网关的第1个核心概念,必须同时说明Kong 2.0.5对象、执行阶段、故障边界和观测证据、↡Kong服务器是第1章 全面了解Kong网关的第2个核心概念,必须同时说明Kong 2.0.5对象、执行阶段、故障边界和观测证据、↡Admin API是第1章 全面了解Kong网关的第3个核心概念,必须同时说明Kong 2.0.5对象、执行阶段、故障边界和观测证据、↡数据库是第1章 全面了解Kong网关的第4个核心概念,必须同时说明Kong 2.0.5对象、执行阶段、故障边界和观测证据、↡路由是第1章 全面了解Kong网关的第5个核心概念,必须同时说明Kong 2.0.5对象、执行阶段、故障边界和观测证据
这些词构成本页词汇。每个词都要回答:由谁创建,保存在哪里,在哪个请求或配置阶段生效,失败后留下什么,怎样观测,以及Kong 2.0.5之后哪些变化不属于本书。
原书目录逐节点重构
1.1 网关简介
目录节点 1/20。 网关简介服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“本章输入与版本契约”进入“网关简介”,随后到“网关的由来”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.1.1 网关的由来
目录节点 2/20。 网关的由来服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“网关简介”进入“网关的由来”,随后到“网关的作用”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.1.2 网关的作用
目录节点 3/20。 网关的作用服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“网关的由来”进入“网关的作用”,随后到“Kong网关简介”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.2 Kong网关简介
目录节点 4/20。 Kong网关简介服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“网关的作用”进入“Kong网关简介”,随后到“Kong网关的发展历程”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.2.1 Kong网关的发展历程
目录节点 5/20。 Kong网关的发展历程服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong网关简介”进入“Kong网关的发展历程”,随后到“Kong网关与传统网关对比”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.2.2 Kong网关与传统网关对比
目录节点 6/20。 Kong网关与传统网关对比服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong网关的发展历程”进入“Kong网关与传统网关对比”,随后到“其他主流网关”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.2.3 其他主流网关
目录节点 7/20。 其他主流网关服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong网关与传统网关对比”进入“其他主流网关”,随后到“Kong网关基础组件”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.3 Kong网关基础组件
目录节点 8/20。 Kong网关基础组件服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“其他主流网关”进入“Kong网关基础组件”,随后到“Kong服务器”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.3.1 Kong服务器
目录节点 9/20。 Kong服务器服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong网关基础组件”进入“Kong服务器”,随后到“数据库”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.3.2 数据库
目录节点 10/20。 数据库服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong服务器”进入“数据库”,随后到“Kong管理GUI”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.3.3 Kong管理GUI
目录节点 11/20。 Kong管理GUI服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“数据库”进入“Kong管理GUI”,随后到“Kong网关安装指南”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.4 Kong网关安装指南
目录节点 12/20。 Kong网关安装指南服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong管理GUI”进入“Kong网关安装指南”,随后到“在Mac环境中安装Kong网关”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.4.1 在Mac环境中安装Kong网关
目录节点 13/20。 在Mac环境中安装Kong网关服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“Kong网关安装指南”进入“在Mac环境中安装Kong网关”,随后到“在Linux环境中安装Kong网关”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.4.2 在Linux环境中安装Kong网关
目录节点 14/20。 在Linux环境中安装Kong网关服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“在Mac环境中安装Kong网关”进入“在Linux环境中安装Kong网关”,随后到“在Docker环境中安装Kong网关”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.4.3 在Docker环境中安装Kong网关
目录节点 15/20。 在Docker环境中安装Kong网关服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“在Linux环境中安装Kong网关”进入“在Docker环境中安装Kong网关”,随后到“使用Kong网关搭建Web应用”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.5 使用Kong网关搭建Web应用
目录节点 16/20。 使用Kong网关搭建Web应用服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“在Docker环境中安装Kong网关”进入“使用Kong网关搭建Web应用”,随后到“示例项目介绍”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.5.1 示例项目介绍
目录节点 17/20。 示例项目介绍服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“使用Kong网关搭建Web应用”进入“示例项目介绍”,随后到“后端服务路由”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.5.2 后端服务路由
目录节点 18/20。 后端服务路由服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“示例项目介绍”进入“后端服务路由”,随后到“静态页面代理”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.5.3 静态页面代理
目录节点 19/20。 静态页面代理服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“后端服务路由”进入“静态页面代理”,随后到“本章小结”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
1.6 本章小结
目录节点 20/20。 本章小结服务于“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”。先识别它在Kong 2.0.5中属于客户端、Nginx/OpenResty、Route、Service、Plugin、Upstream、Target、数据库、控制面还是外部平台,再写清输入、状态变化、输出与所有者。结论必须能从配置、命令输出、Admin API响应、代理轨迹、日志和业务结果复核。
机制轨迹从“静态页面代理”进入“本章小结”,随后到“本章证据门与回退”。沿请求接入、路由匹配、插件阶段、上游选择、响应过滤和日志阶段记录时间线;配置加载、缓存传播、进程重载、节点故障与重试必须各有分支。任何“已启动”“返回2xx”或“界面可见”都只是中间状态。
实验固定Kong 2.0.5、OpenResty、数据库模式、请求集合、Route和Service,只改变路径或Host、插件、Target权重、失败节点、并发或部署状态之一。保存吞吐、P50/P95/P99、错误率、上游分布、worker和数据库指标,并用“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”验收。
独立证据与生产交接
目录证据保存16章4附录与280个唯一节点映射;环境证据保存Kong 2.0.5、OpenResty、LuaJIT、数据库、插件和外部平台版本;配置证据保存来源优先级、声明文件、Admin API请求响应和生效时间;请求证据保存关联ID、Route、Service、Plugin、Upstream、Target与最终业务结果。
性能判断固定请求集合、并发模型、连接复用、插件链、上游容量、数据库模式和日志策略。关闭认证、日志或健康检查换来的吞吐不是等价优化。平均值会隐藏worker停顿、缓存失效、数据库抖动、上游重试与节点切换,必须保留P95/P99和错误分类。
恢复判断从业务状态结束。进程重启、Pod Ready、HAProxy重新放行、配置重新可见或监控恢复都只是阶段;还要核对非幂等请求、上游副作用、Consumer身份、配置版本和旧节点是否停止提供错误结果。
本章回顾
重新完成“从网关由来、职责、Kong发展与基础组件进入安装和首个Web代理项目”:固定Kong 2.0.5和权威目录,从请求与配置状态机推导边界,通过基线、压力与故障实验测量,最后交付网关职责表、组件拓扑、三平台安装记录、Web应用路由与静态资源代理验收。只有“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”与反例都能由另一位读者独立重放,本页才算完成。
复习与运行验收
练习
问题 1:为什么“第1章 全面了解Kong网关”必须覆盖20个目录节点?
问题 2:本页最小不变量是什么?
问题 3:怎样构造最小反例?
问题 4:为什么不能直接用新版Kong替代本页实验?
问题 5:如何验证性能结论?
问题 6:独立交接需要什么?
名词解释
本章出现的专业名词,用大白话再讲一遍。
- 网关层
网关层在本页对应Kong 2.0.5中的具体对象、配置或状态;适用范围由“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”和故障反例共同限定。
- Kong服务器
Kong服务器在本页对应Kong 2.0.5中的具体对象、配置或状态;适用范围由“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”和故障反例共同限定。
- Admin API
Admin API在本页对应Kong 2.0.5中的具体对象、配置或状态;适用范围由“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”和故障反例共同限定。
- 数据库
数据库在本页对应Kong 2.0.5中的具体对象、配置或状态;适用范围由“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”和故障反例共同限定。
- 路由
路由在本页对应Kong 2.0.5中的具体对象、配置或状态;适用范围由“同一后端在Kong 2.0.5上完成动态服务路由与静态页面代理,Admin API和代理端口边界清楚且可复现”和故障反例共同限定。