Kong网关：入门、实战与进阶

适读人群 ：本书的读者主要面向系统架构师、网关研发工程师，DevOps研发工程师，或者对最新前沿技术感兴趣的技术人员。读者需要对系统架构整体设计、微服务治理有一定经验，或者对传统网

（1）作者资历深厚：作者是资深架构师，现任上海某科技公司CTO，曾就职于华为和中国移动；

（2）作者经验丰富：近10年开发和架构经验，对大规模分布式、微服务、Kong网关等方面有深入研究，积累了丰富的实战经验；
（3）内容十分扎实：从核心概念、使用方法、工作原理、工程实践、源码分析等多个维度对Kong网关进行抽丝剥茧；
（4）技术融会贯通：本书不只是讲Kong网关本身，同时还将微服务设计、分布式架构、DevOps、敏捷开发等技术融于一体；

作者简介
孔庆雍
毕业于同济大学，曾就职于华为、中国移动、数禾科技等多家公司，任职期间参与了多个大型系统设计、研发工作。现任上海珞瑾数据信息有限公司CTO、首席架构师，在现公司主导了内部自研DevOps平台的搭建及底层架构设计与规划。敏捷开发思想践行者，擅长利用技术推进项目管理与产品交付。
在企业级SaaS服务、大规模分布式架构、微服务治理、网关层设计研发等领域积累了丰富的经验，在现公司主导研发的酒店管理系统已累计覆盖10万家门店，日均请求量超1亿。
想要了解有关作者的更多信息，可以关注公众号“熊猫CTO”。作者会在公众号内定期分享互联网生态中有关技术、设计、产品、运营等主题的原创文章。您也可以在公众号下留言互动。

前　言
入　门　篇
第1章　全面了解Kong网关 2
11　网关简介 2
111　网关的由来 3
112　网关的作用 3
12　Kong网关简介 6
121　Kong网关的发展历程 6
122　Kong网关与传统网关对比 6
123　其他主流网关 7
13　Kong网关基础组件 12
131　Kong服务器 12
132　数据库 13
133　Kong管理GUI 14
14　Kong网关安装指南 14
141　在Mac环境中安装Kong网关 15
142　在Linux环境中安装Kong网关 15
143　在Docker环境中安装Kong网关 15
15　使用Kong网关搭建Web应用 16
151　示例项目介绍 16
152　后端服务路由 18
153　静态页面代理 20
16　本章小结 24
第2章　Nginx必备知识 25
21　Nginx安装 25
211　在Mac环境中安装Nginx 25
212　在Linux环境中安装Nginx 26
213　在Docker环境中安装Nginx 26
22　Nginx详解 26
221　Nginx文件的目录结构 26
222　命令行参数 28
223　配置文件 29
224　依赖库 32
225　Nginx的工作原理 33
226　Nginx优化指南 35
23　项目实践 37
231　从Kong切换到Nginx 37
232　添加黑白名单 39
233　添加限流 39
234　从Nginx切换到Kong 41
235　小结 41
24　本章小结 42
第3章　Lua必备知识 43
31　Lua入门与规范 43
311　基础知识 43
312　安装指南 44
313　解释器 45
314　语法规范 46
32　数据类型 47
33　操作符 52
34　表达式语句 54
341　赋值语句 54
342　控制语句 55
35　Lua库 58
36　本章小结 62
第4章　OpenResty必备知识 63
41　OpenResty入门安装 63
411　在Mac环境中安装OpenResty 63
412　在Linux环境中安装OpenResty 64
413　在Docker环境中安装OpenResty 64
42　OpenResty详解 64
421　OpenResty服务器的目录结构 64
422　Resty CLI 65
423　OpenResty包管理工具 67
43　OpenResty工作原理 69
44　OpenResty性能优化 71
441　避免使用阻塞函数 72
442　巧用table组件 72
443　使用缓存 73
444　火焰图 73
45　项目实践 75
46　本章小结 82
基　础　篇
第5章　Kong网关配置与部署 84
51　Kong启动项配置 84
511　配置项加载流程 85
512　配置项详解 86
513　环境变量 89
514　配置文件示例 89
52　注入Nginx指令 90
521　注入单个Nginx指令 91
522　通过文件方式注入Nginx指令 92
53　个性化使用场景 92
531　自定义Nginx模板文件 93
532　在OpenResty实例中嵌入Kong 93
54　Kong网关部署 94
541　无数据库部署模式 94
542　数据库部署模式 97
543　混合部署模式 100
55　本章小结 102
第6章　Kong网关命令行 103
61　通用标志参数 104
62　Kong网关命令行详解 104
621　kong check 104
622　kong config 106
623　kong health 109
624　kong hybrid 109
625　kong migrations 110
626　kong prepare 112
627　kong quit 113
628　kong reload 113
629　kong restart 114
6210　kong start 114
6211　kong stop 115
6212　kong version 116
63　本章小结 116
第7章　Kong网关代理及鉴权 117
71　Kong网关代理基础知识 117
711　Kong网关术语简介 117
712　Kong网关代理环境配置 118
72　Kong网关代理示例 118
73　路由匹配规则 121
731　通用匹配规则 121
732　paths属性 123
733　hosts属性 126
734　methods属性 128
735　headers属性（hosts除外） 129
736　sources & destinations属性 129
737　snis属性 129
74　路由匹配优先级 130
741　优先级策略 130
742　后备路由策略 131
75　Kong网关代理行为 132
751　超时机制 132
752　错误重试机制 133
753　插件执行策略 133
754　响应内容 133
76　配置SSL协议 134
77　代理WebSocket流量 135
78　代理gRPC流量 138
79　Kong网关鉴权 140
791　通用鉴权流程 140
792　匿名接入流程 142
793　多重认证策略 143
710　本章小结 144
第8章　Kong网关负载均衡策略与健康检查 145
81　负载均衡 145
811　负载均衡简介 145
812　负载均衡解决方案 146
813　Kong网关中的负载均衡 146
82　基于DNS的负载均衡 146
821　A记录（包含AAAA记录） 147
822　SRV记录 147
823　DNS 记录优先级 147
824　其他注意事项 148
83　环状负载均衡器 148
831　基础概念 148
832　负载均衡策略 150
833　其他注意事项 151
84　负载均衡特性使用场景 151
841　蓝绿发布 151
842　金丝雀发布 155
85　健康检查 157
851　健康检查标准 157
852　健康检查类型 159
853　健康检查配置 160
86　本章小结 162
进　阶　篇
第9章　Kong网关插件 164
91　Kong网关插件简介 164
911　Kong网关插件概念 164
912　Kong网关插件原理 165
92　Kong官方插件 166
921　鉴权类插件 166
922　安全类插件 177
923　流量类插件 179
924　分析监控类插件 195
925　内容转换类插件 197
926　日志类插件 204
927　其他插件 210
93　自定义Kong网关插件 210
931　自定义插件开发流程和插件生命周期管理详解 210
932　插件开发套件 240
933　Go插件开发向导 241
934　自定义插件实例 243
94　本章小结 245
第10章　Kong网关日志 246
101　Kong网关日志简介 246
1011　Kong网关日志分类 246
1012　Kong网关日志级别 248
102　Kong网关结合日志平台 249
1021　ELK方案简介 249
1022　Kong网关结合ELK 253
1023　日志系统使用场景 256
103　自定义日志 261
1031　Kong网关定制日志 262
1032　ELK定制日志 264
1033　小结 265
104　本章小结 266
第11章　Kong网关运维 267
111　资源选型 267
1111　服务器资源 267
1112　数据库资源 268
1113　弹性伸缩 269
1114　性能参数 269
112　Kong网关监控 270
1121　监控平台选型 270
1122　搭建监控平台 271
1123　Kong网关监控平台配置 272
1124　Kong网关监控平台指标详解 278
1125　Kong监控平台指标测试 279
1126　Kong监控平台的预警功能 281
113　Kong网关运维 284
1131　数据备份 284
1132　软/硬件维护 286
1133　突发事件处理 288
114　本章小结 288
第12章　Kong网关安全与集群高可用 289
121　Kong网关安全配置 289
1211　网络层访问限制 289
1212　Kong API 回路 290
1213　自定义Nginx配置 291
122　Kong集群 292
1221　Kong集群简介 292
1222　Kong集群缓存 293
123　Kong网关高可用 298
1231　架构设计 298
1232　引入HAProxy层 300
1233　高可用方案测试 301
124　本章小结 308
应　用　篇
第13章　Kong网关结合微服务架构 310
131　微服务简介 310
1311　微服务的优点 311
1312　单体应用和微服务 311
1313　微服务12要素 313
132　单体应用向微服务迁移 313
1321　采用微服务的注意事项 314
1322　迁移细节 314
133　使用CI/CD流程促进微服务开发 316
1331　CI/CD流程基础组件 316
1332　构建CI/CD流程 318
134　基于Kong打造DevOps平台 320
1341　场景描述 320
1342　设计思路 321
1343　DevOps平台使用指南 325
1344　DevOps平台源码解析 329
1345　DevOps平台扩展 335
135　本章小结 336
第14章　Kong网关结合Kubernetes架构方案 337
141　Kubernetes详解 337
1411　Kubernetes简介 337
1412　Kubernetes发展史 338
1413　Kubernetes基本概念和术语 340
1414　Kubernetes的HelloWorld示例 342
142　Kubernetes与Kong网关结合 350
1421　概念描述 350
1422　使用Kubernetes安装Kong 358
143　Kubernetes实战 359
1431　安装Kong网关 359
1432　使用Kong网关 360
1433　配置Kong网关插件 361
144　本章小结 363
第15章　Service Mesh实践之Kuma 364
151　Service Mesh简介 364
152　Kuma简介 366
1521　为什么使用Kuma 366
1522　Kuma与其他Service Mesh方案的比较 366
1523　Kuma系统组件 367
1524　Kuma部署示例 368
153　Kuma策略概述 369
1531　策略配置项描述 369
1532　使用策略 370
1533　策略匹配规则 371
154　Kuma内置策略详解 372
1541　安全类策略 372
1542　流量控制类策略 376
1543　观测类策略 382
155　Kuma实战 388
1551　适配Kuma架构 388
1552　启动mTSL和TrafficPermission 390
156　本章小结 391
第16章　Serverless架构 392
161　Serverless简介 392
1611　系统架构演

为什么要写这本书
随着公司业务发展、技术架构升级，网关层的重要性在系统整体架构中日益凸显。Kong网关作为新一代网关技术，不仅可以解决技术架构升级的痛点问题，也可以与DevOps理念有机结合，以技术推动产品业务发展，达到开发、测试、交付、运营多个维度的提升。
Kong网关的应用横跨互联网、电信、金融、制造、食品等领域，雅虎、GE、Honeywell、VMWare、Cisco、NASDAQ、MasterCard等多家大型企业都在使用。同时，Kong公司也是CNCF的成员之一，一直在积极推动云原生应用的发展。但相对而言，Kong网关在国内显得不温不火，一个主要原因是国内研发人员对网关层的认识还比较模糊，大家主要关注的是业务层代码；另一个原因是大家对网关层的认识相对局限，由于众多与各语言栈绑定的网关组件的存在（如Zuul、Spring Cloud Gateway等），而忽视了更高维度的网关层的必要性。
本书的初衷之一是在国内推广Kong网关技术，利用Kong网关强大的性能和易于定制的特点帮助企业打造更符合现代软件架构的网关层，解决技术转型难题；同时分享一些笔者使用Kong网关的经验，力求让读者能有所收获。最后，希望能和读者一起从Kong网关出发，了解更多、更前沿的技术走向，在技术的洪流中扬帆远航。
读者对象
本书的推荐读者对象包含但不限于：
网关研发工程师、Kong网关插件开发工程师
系统架构师、DevOps工程师
对网关技术感兴趣，并希望快速入门、进阶的IT工程师
对系统架构设计、微服务治理、云原生环境等前沿技术感兴趣的技术爱好者
本书特色
通过本书，笔者将带领大家快速入门Kong网关，帮助读者建立起网关层相关的完整知识体系，进而了解系统架构设计的全貌。本书的特点如下。
本书知识点由浅入深、层层递进。通过严谨、清晰的脉络结构，对Kong网关涉及的重点、难点知识逐一进行梳理、讲解。
本书全文配以大量实战项目和源码分析，理论结合实践，帮助读者直观、高效地掌握网关层相关知识，并快速应用于实际环境。
本书以Kong网关为线索，还会涉及系统架构设计、微服务治理、DevOps技术实践、敏捷思想落地等众多领域，为读者还原现代技术架构的方方面面。
除技术讨论之外，本书还会分享一些常用的学习方法论，以便读者在学习其他技术时也能用到，达到事半功倍的效果。
如何阅读本书
本书总共分为四篇。
入门篇（第1～4章）：主要引导读者对Kong网关有一个概要性认知，介绍了它的基础使用指南和相关理论，以及一些掌握Kong网关必备的知识。
基础篇（第5～8章）：前两章着重介绍了Kong网关的基础配置、部署方案和命令行向导；后两章介绍了Kong网关的代理、鉴权、负载均衡策略、健康检查机制等一系列常用功能。
进阶篇（第9～12章）：介绍了Kong网关区别于其他传统网关的插件机制，同时介绍了Kong网关在整个架构体系中与其他系统（诸如日志系统、网络安全等）的交互。
应用篇（第13～16章）：结合当前日益成熟的云原生环境，介绍了Kong网关针对不同场景给出的解决方案。
其中，后三篇的每一章都包含了大量示例工程。读者可以直接使用Docker运行，结合实战更好地理解书中所讲的内容。如果读者已经是一名经验丰富的资深用户，或者可熟练使用其他网关层组件，则可以根据目录结构按需阅读；如果读者是一名初学者，或者希望更系统、扎实地了解Kong网关技术，推荐从入门篇的理论知识开始学习。
勘误和支持
由于笔者水平有限，编写时间仓促，书中难免会出现一些错误或者不准确的地方，恳请读者批评指正。书中的全部源文件可以从华章网站下载。如果你有更多宝贵意见和想法，可以关注公众号“熊猫CTO”与我沟通。公众号中提供了勘误表，也会定期更新一些书籍相关的补充内容，欢迎大家订阅。非常期待得到大家的真挚反馈。
致谢
首先要感谢Kong公司和社区的不懈努力，为我们打造了一款如此强大的软件，使我们能站在巨人的肩膀上阔步前行。
其次，本书的写作离不开各位小伙伴的支持和帮助。他们为本书提供了非常多的宝贵建议和贡献，这里依次对他们表示感谢：书中大量的环境搭建和示例设计均由叶宁配合完成，他也是一位Kong网关的资深运维专家，示例结果也由他反复验证；书中多个章节的大量实战源码的贡献者是方昆、李坤、廖云和吴俊（按姓氏首字母排序）。除此之外，还有很多给予过我帮助的小伙伴，是他们的无私付出使本书的内容更加饱满。
这里还要感谢机械工业出版社华章公司的杨福川老师，在这一年多的时间里他始终支持我写作，是他的鼓励和帮助引导我顺利完成全部书稿；同时要感谢董惠芝老师在写作期间对我提供的细心指导和建议，是她细致的审稿和编排，才得以让本书完整呈现。
最后还要特别感谢我的父母、妻子和家人，感谢他们对我自始至终的关心和支持。谨以此书献给我最亲爱的家人们，希望他们永远幸福快乐！

孔庆雍
2021年4月