第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取得配置、路由匹配、插件执行、上游完成、客户端收到响应和业务状态落定是不同检查点。超时与重试还可能让一次客户端请求触发多次上游操作,非幂等操作必须单独验证。

核心词汇与版本边界

这些词构成本页词汇。每个词都要回答:由谁创建,保存在哪里,在哪个请求或配置阶段生效,失败后留下什么,怎样观测,以及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和代理端口边界清楚且可复现”和故障反例共同限定。

← 上一页:原书权威学习地图 · 下一页:第2章 Nginx知识 →

资料与写作方式声明

本章以孔庆雍《Kong网关:入门、实战与进阶》权威目录界定学习范围,并结合正文列出的技术资料独立重写;不宣称复现原书正文,也不沿用原作表述。

原作版权归作者与出版社所有;本站原创教学结构与表述仅供学习交流。

讨论

评论区加载中…