kong 网关研究系列一 学习与实践备忘录

Kong网关安装部署问题汇总

目录
目录 II
1.1 安装Konga连接postgresql时出错 1
1.2 路由配置部分参数需要按回车键才能提交保存 2
1.3 OAuth 2.0插件配置说明 2
1.4 Konga告警异常 4
1.5 SkyWalking插件 5
1.6 PostgreSQL连接时用户认证失败 6

Kong网关学习与实践备忘录

1.1 安装Konga连接postgresql时出错

按照Konga官方文档安装Konga，在连接postgresql时connection-uri格式不正确导致连接数据库失败。

查看postgresql官方文档，可以看到connection-uri支持的格式如下图所示：

由于安装postgresql的时候设置了数据库密码，因此需要在connection-uri中填写密码：postgresql://kong:123456@119.91.33.145:5432/konga

1.2 路由配置部分参数需要按回车键才能提交保存

新增或者修改路由Paths参数，输入之后需要按回车，否则提交时校验为空值：

由于Paths参数可以输入多个值，而Konga通过按回车键进行多个参数的输入，但是在前端页面并没有提示信息。如果没有按回车键，提交时则认为参数为空导致校验不通过。

1.3 OAuth 2.0插件配置说明

添加OAuth 2插件时，插件提供了四种授权模型，这里选择开启client credentials模式：

给消费者添加凭证时redirect_uris参数需要填写实际路由的地址，并且需要按回车键：

按照上述配置OAuth 2获取令牌时请求的url路径为https://110.42.229.44:8443/my-path/oauth2/token，需要注意的是该插件只允许通过https协议并且只支持Post请求获取令牌，因此如果没有配置ssl证书，使用Postman测试时需要关闭ssl校验，否则无法测试。

1.4 Konga告警异常

在更新upstream 之后健康检查会停止，这个是个官方遗留bug

在评论回复中看到解决办法是将lua-resty-healthcheck 插件版本升级到2.0.0，通过这次问题排查，也学习到了解决问题的思路：首先需要分析Konga告警功能的实现逻辑，为此查阅了Konga的相关源码，可以看到Konga调用的是Kong healthcheck功能模块的接口，手动调用该接口发现了异常，因此可以定位问题出现在healthcheck模块。

1.5 SkyWalking插件

引入skywalking插件 时需要注意 我们进入容器时的用户是kong， 而需要调整的/usr/local/share/lua/5.1/kong/constans.lua  文件 归属权为root 用户。所以需要再进入容器时使用如下命令：--user  root
docker exec -it --user root 3581f830fa8d sh
之后进入到如下路径：/usr/local/share/lua/5.1/kong/，调整constans.lua。之后重启节点。

如果kong采用了集群多活的部署，则每个节点都需要进行插件的安装。
skywalking 集成邮件告警的实践中， 在告警结构体中 由于网上版本大多数是6.5的版本。结构体中：id0 跟id1 均为int 类型。而我们使用的8.3版本，则再实际发送告警消息时，结构体的id0与id1类型为String, 如果未修改，则报错如下。

在配置skywalking的告警时，关于skywalking-aop-server 组件中
修改文件：/skywalking/config下的alarm-settings.yml，除了规则制定之外，还有达到告警规则后，需要skywalking调用的webhook接口，如上所示的配置，一定要注意url的缩进，之前缩进两个空格，一直没生效。配置完成之后，重启skywalking生效。

1.6 PostgreSQL连接时用户认证失败

输入用户名密码连接数据库时报错：FATAL: Ident authentication failed for user "root"，解决办法：修改PostgreSQL有关用户认证的配置文件，在PostgreSQL安装目录下找到配置文件所在位置：

修改pg_hba.conf文件：vi pg_hba.conf

将IPv4 local connections METHOD改成trust。保存退出，重新启动PostgreSQL：
sudo systemctl restart postgresql