Linux下源码安装Kong网关

    kong是基于openresty构建的一个网关,并且直接带了很多的功能比如反向代理、负载均衡、限流等模块直接开箱即用,同时兼具OpenResty的高性能,大部分情况下无需编程就可以实现想要的功能,下面在CentOS8 Linux上使用源码编译的方式安装kong,kong的官网是:https://konghq.com/,github仓库:https://github.com/kong/kong

    kong安装文档:https://konghq.com/install/

    kong安装需要依赖好几个组件官网上给出了依赖的列表如下:

    总体上这些组件可以依次手动安装但是比较麻烦,所以推荐通过kong提供的工具kong-build-tools进行安装,仓库链接为:https://github.com/Kong/kong-build-tools,可以通过git克隆下来或者在首页下载zip包下来然后解压先准备好并且进入到目录中,然后开始进行组件的安装

    编译需要先安装zlib库: yum install zlib-devel ,如果不安装待会编译会提示错误,然后就可以开始使用工具安装:

./openresty-build-tools/kong-ngx-build --prefix /opt/kong --work work --openresty 1.15.8.3 --openssl 1.1.1g --kong-nginx-module master --luarocks 3.3.1 --pcre 8.44 --jobs 6 --force

    这个工具也相当于一键安装了,--prefix指定这些组件的统一目录,默认是/usr/local,然后--work指定安装的工作目录,这些包如果不存在都会临时下载到这里面然后再进行编译,安装完之后就没啥用了,后面的这些参数都是文档上推荐的稳定版本,执行之后需要耐心等待下载、编译以及安装,需要几分钟的时间,安装之后到/opt/kong可以看到luarocks、openresty、openssl这3个目录,然后将下面的环境变量添加到/etc/profile中:

export KONG_DIR=/opt/kong
export OPENSSL_DIR=$KONG_DIR/openssl
export PATH=$KONG_DIR/openresty/bin:$KONG_DIR/openresty/nginx/sbin:$OPENSSL_DIR/bin:$KONG_DIR/luarocks/bin:$PATH

    添加之后 source /etc/profile 然后分别执行下面的命令查看各个组件的版本:

openssl version -a
nginx -V
resty -v
openresty -V
luarocks --version

    确认没问题说明基础环境已经安装完成,然后需要安装libyaml-devel组件,否则接下来编译Kong会报错,centos8上面默认源没有libyaml-devel需要启用powertools才可以,centos7直接安装即可:

dnf config-manager --set-enabled PowerTools

    然后才可以开始安装:

dnf install libyaml-devel
# 或者用yum
yum install libyaml-devel

    然后开始编译kong:

cd /opt/kong
git clone https://github.com/Kong/kong.git
cd kong
git checkout 2.1.0

    这里选择的是2.1.0稳定版,直接下载master上面的代码其实也是可以的,如果克隆比较慢可以去仓库下载打好的tag:

     然后解压到/opt/kong,再把目录名改为kong即可,总之最后的目录是:/opt/kong/kong,具体过程不再赘述,准备好之后直接安装kong:

make install

    安装的过程其实就是下载了很多lua的模块然后进行安装,正常是安装到luarocks下,可能速度非常慢,需要耐心等待如果失败了可以再次执行会继续安装,再不行需要自行解决网络问题……,最后安装成功需要继续添加下面的环境变量:

export PATH=/opt/kong/kong/bin:$PATH

    然后按照官网的说明查看kong的版本信息:

kong version --vv

    其实这里执行肯定会报错,socket或其他的模块找不到的错误,如果用rpm包安装是没问题的,原因就是lua模块安装到了/opt/kong/luarocks下,而这个路径不再默认的搜索路径下,于是继续添加下面的变量到profile:

export LUA_PATH="/opt/kong/luarocks/share/lua/5.1/?.lua;;"

    保存并source之后,再执行上面的命令就可以看到输出的信息了

    到这里kong就安装成功了,然后要正常使用还需要配置数据库,数据库支持postgresql以及cassandra,当然也可以不使用数据库,但是不使用数据库将无法添加服务以及路由,正常用于导出yml线上发布使用,这里使用的是postgresql,具体安装请参考之前的文章以及官方文档,下面直接进行kong的相关配置

    在pgsql中创建角色以及数据库:

CREATE ROLE kong LOGIN PASSWORD 'kong123456';
CREATE DATABASE kong OWNER kong;

    这里创建角色kong允许登录,并且设置密码为kong123456,然后创建了数据库kong并授权给角色kong,然后修改postgresql的权限配置文件:pg_hba.conf,添加远程访问的权限如下:

host    kong            kong            192.168.0.0/16          md5

    这里的允许ip根据实际情况设置,如果postgresql是在本地那么就没必要配置权限了,默认不用密码就可以登录,修改完配置文件重启postgresql服务即可

    然后进入到kong的目录编辑配置:

cd /opt/kong/kong
cp kong.conf.default kong.conf

    然后编辑配置文件kong.conf,修改数据库部分的配置如下:

database = postgres
pg_host = 192.168.0.31
pg_port = 5432
pg_timeout = 5000
pg_user = kong
pg_password = kong123456
pg_database = kong

    保存配置然后开始执行下面的命令初始化数据库:

kong migrations bootstrap -conf kong.conf

    注意指定kong启动服务的时候要在目录/opt/kong/kong下,否则可能会报kong加载失败,如下:

    如果觉得每次进入目录麻烦,那么直接在刚才的环境变量LUA_PATH追加path:/opt/kong/kong/?/init.lua,/opt/kong/kong下面有1个kong目录保存了相关模块的源码,因此这么配置就可以在外部加载kong这个目录了:

export LUA_PATH="/opt/kong/luarocks/share/lua/5.1/?.lua;/opt/kong/kong/?/init.lua;;"

    配置的时候要仔细看一下目录,如果你的和我这里的不一样,要根据实际的配置,然后可以启动一个独立的kong项目,kong项目启动的时候如果指定-conf会读取指定的配置如果不指定则默认会读取/etc/kong/kong.conf这个配置,所以这里我们可以将配置文件放到/etc/kong/kong.conf,之后改配置也要改这个,这样就不用每次指定配置文件了,可以方便操作:

mkdir /etc/kong
cp /opt/kong/kong/kong.conf /etc/kong

    然后可以启动一个新的项目:

kong start --prefix /opt/kong-work

    这里--prefix指定工作目录的位置,就是和nginx默认的conf一样的结构,和上篇文章创建openresty项目的思路完全一样,如果不想指定可以修改kong.conf配置prefix参数,默认值是/usr/local/kong,修改之后就不用--prefix指定了,如果有多个项目的话其他的项目还是需要用--prefix单独指定的

    kong启动之后会监听如下4个端口:

    8000 - 这个是提供网关服务的端口,会侦听http客户端的流量然后转发到上游服务

    8443 - 和8000一样,只是这个是侦听https流量

    8001 - 配置kong admin api的端口,为了安全默认只监听127.0.0.1回环网卡

    8444 - 和8001一样,管理https admin api

    启动之后可以使用下面的命令验证一下服务:

curl --include http://localhost:8001

    默认正常返回json即表示启动成功,正常返回一堆json不太好看,可以用python3的json模块或者json_pp进行格式化示例如下:

curl http://localhost:8001 | python3 -m json.tool
# 或者
curl http://localhost:8001 | json_pp

    停止kong服务和重新加载配置可以使用下面的命令:

kong stop --prefix <prefix>
kong reload --prefix <prefix>

    最后创建一个简单的http proxy来验证kong的功能如下:

# 创建服务 代理到文档上的指定服务
curl -X POST --url http://localhost:8001/services --data 'name=test-service' --data 'url=http://mockbin.org' | json_pp
# 创建路由规则 支持hosts,paths,headers等
curl -X POST --url http://localhost:8001/services/test-service/routes --data 'paths[]=/test' | json_pp
# 访问网关测试
curl -X GET http://localhost:8000/test

    然后可以访问浏览器看一下:

     可能是资源路径的原因这里样式丢失了,这样kong的服务就全部配置好并且可以使用了,只是这个缺点是没有管理的页面导致每次用curl发送请求比较麻烦,而且官方的页面需要付费,这里推荐个比较好用的第三方界面konga:https://github.com/pantsel/konga,其他的不是版本跟不上就是有或多或少的问题,这个应该算是第三方的里面比较优秀而且功能非常全的一个了,推荐研究和使用

    我也是第一次接触这个网关,如有错误欢迎指正~

 

posted @ 2020-08-12 17:54  小得盈满  阅读(1682)  评论(0编辑  收藏  举报