【kong 2.0.2研究】系列一：centos7手动指定安装kong

本是古典何须时尚 2023-05-28 09:50 6阅读 0赞

最近研究kong，这里记录一下

# 1、说明 #

[Nginx][]、[OpenRestry][]、[Kong][]这三个项目紧密相连：

1.  Nginx是模块化设计的反向代理软件，C语言开发；
2.  OpenResty是以Nginx为核心的Web开发平台，可以解析执行Lua脚本（OpenResty与Lua的关系，类似于Jvm与Java，不过Java可以做的事情太多了，OpenResty主要用来做Web、API等）；
3.  Kong是一个OpenResty应用，是一个api gateway，具有API管理和请求代理的功能。

![format_png][]

## 1.1 git地址 ##

[https://github.com/Kong/kong][https_github.com_Kong_kong]

## 1.2 kong安装说明 ##

[https://docs.konghq.com/install/source/][https_docs.konghq.com_install_source]

## 1.3 openssl ##

[https://www.openssl.org/source/][https_www.openssl.org_source]

# 2 下载lua-kong-nginx-module #

[https://github.com/Kong/lua-kong-nginx-module][https_github.com_Kong_lua-kong-nginx-module]

# 3. 安装OpenResty #

[https://openresty.org/en/download.html][https_openresty.org_en_download.html]

./configure \\  
   --prefix=/home1/zcy/kong/openresty \\  
   --with-pcre-jit \\  
   --with-http\_ssl\_module \\  
   --with-http\_realip\_module \\  
   --with-http\_stub\_status\_module \\  
   --with-http\_v2\_module \\  
   **--with-openssl=/home1/zcy/kong/openssl-1.1.1c \\  
   --add-module=/home1/zcy/kong/lua-kong-nginx-module **

报错：you need to have ldconfig in your PATH env when enabling luajit

解决方法：编辑Makefile文件，将can\_run("ldconfig")改成can\_run("/sbin/ldconfig")

# 4 安装Luarocks #

./configure \\  
   --lua-suffix=jit \\  
   --with-lua=/home1/zcy/kong/openresty/luajit \\  
   --with-lua-include=/home1/zcy/kong/openresty/luajit/include/luajit-2.1 \\  
   --prefix=/home1/zcy/kong/luarocks

配置环境：

export PATH=$PATH:/home1/zcy/kong/openresty/bin:/home1/zcy/kong/luarocks/bin:  
export LUA\_PATH="/home1/zcy/kong/luarocks/share/lua/5.1/?.lua;;/home1/zcy/kong/luarocks/share/lua/5.1/?/init.lua;"

# 5. 安装kong #

**luarocks 安装：**  
$luarocks make kong-\*.rockspec

$luarocks install kong 2.0.2-0

**或者**  
$ git clone git@github.com:Kong/kong.git  
$ cd kong  
$ \[sudo\] make install \# this simply runs the \`luarocks make kong-\*.rockspec\` command

## **install成功** ##

lua-resty-lrucache 0.09-2 is now installed in /home1/zcy/kong/luarocks (license: 2bsd)

lua-resty-acme 0.4.3-1 depends on lua-resty-openssl >= 0.2.1-1 (0.4.4-1 installed)  
lua-resty-acme 0.4.3-1 is now installed in /home1/zcy/kong/luarocks (license: BSD)

kong-plugin-acme 0.2.2-1 is now installed in /home1/zcy/kong/luarocks (license: Apache 2.0)

kong 2.0.2-0 is now installed in /home1/zcy/kong/luarocks (license: Apache 2.0)

创建kong的数据库：

./bin/kong migrations up -c ./kong.conf

启动kong:

./bin/kong start -c ./kong.conf

kong默认的代理地址是：

proxy_listen = 0.0.0.0:8000, 0.0.0.0:8443

默认的管理地址是：

admin_listen = 127.0.0.1:8001, 127.0.0.1:8444 ssl

## 验证Kong ##

如果一切顺利，你应该看到一条消息通知你Kong正在运行。

默认情况下，Kong监听以下端口：

*  **8000**：监听来自Client的传入流量，并将其转发到上游服务
 *  **8443**：与8000端口类似，它监听HTTPS流量
 *  **8001**：Admin API用于配置Kong监听
 *  **8444**：Admin API监听HTTPS流量

# 6. 报错解决 #

## 6.1 编译报错，缺少lyaml ##

Error: Failed installing dependency: https://luarocks.org/lyaml-6.2.4-1.src.rock - Could not find library file for YAML  
  No file libyaml.a in /usr/local/lib  
  No file libyaml.a in /usr/local/lib64  
  No file libyaml.so in /usr/local/lib  
  No file libyaml.so in /usr/local/lib64  
  No file matching libyaml.so.\* in /usr/local/lib  
  No file matching libyaml.so.\* in /usr/local/lib64  
  No file libyaml.a in /usr/lib  
  No file libyaml.a in /usr/lib64  
  No file libyaml.so in /usr/lib  
  No file libyaml.so in /usr/lib64  
  No file matching libyaml.so.\* in /usr/lib  
  No file matching libyaml.so.\* in /usr/lib64  
  No file libyaml.a in /lib  
  No file libyaml.a in /lib64  
  No file libyaml.so in /lib  
  No file libyaml.so in /lib64  
  No file matching libyaml.so.\* in /lib  
  No file matching libyaml.so.\* in /lib64  
You may have to install YAML in your system and/or pass YAML\_DIR or YAML\_LIBDIR to the luarocks command.  
Example: luarocks install lyaml YAML\_DIR=/usr/local  
make: \*\*\* \[install\] Error 1

安装libyaml

\# yum downgrade libyaml  
\# yum install libyaml-devel

# #

## 6.2 启动报错 ##

$ kong start -c ./kong.conf   报错

Error: module 'resty.kong.tls' not found:No LuaRocks module found for resty.kong.tls  
        no field package.preload\['resty.kong.tls'\]  
        no file './resty/kong/tls.lua'  
        no file './resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty/kong/tls.ljbc'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty/kong/tls/init.ljbc'  
        no file '/home1/zcy/kong/openresty/lualib/resty/kong/tls.ljbc'  
        no file '/home1/zcy/kong/openresty/lualib/resty/kong/tls/init.ljbc'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty/kong/tls.lua'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/openresty/lualib/resty/kong/tls.lua'  
        no file '/home1/zcy/kong/openresty/lualib/resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/luarocks/share/lua/5.1/resty/kong/tls.lua'  
        no file './resty/kong/tls.lua'  
        no file '/home1/zcy/kong/openresty/luajit/share/luajit-2.1.0-beta3/resty/kong/tls.lua'  
        no file '/usr/local/share/lua/5.1/resty/kong/tls.lua'  
        no file '/usr/local/share/lua/5.1/resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/openresty/luajit/share/lua/5.1/resty/kong/tls.lua'  
        no file '/home1/zcy/kong/openresty/luajit/share/lua/5.1/resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/luarocks/share/lua/5.1/resty/kong/tls/init.lua'  
        no file '/home1/zcy/.luarocks/share/lua/5.1/resty/kong/tls.lua'  
        no file '/home1/zcy/.luarocks/share/lua/5.1/resty/kong/tls/init.lua'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty/kong/tls.so'  
        no file '/home1/zcy/kong/openresty/lualib/resty/kong/tls.so'  
        no file './resty/kong/tls.so'  
        no file '/usr/local/lib/lua/5.1/resty/kong/tls.so'  
        no file '/home1/zcy/kong/openresty/luajit/lib/lua/5.1/resty/kong/tls.so'  
        no file '/usr/local/lib/lua/5.1/loadall.so'  
        no file '/home1/zcy/.luarocks/lib/lua/5.1/resty/kong/tls.so'  
        no file '/home1/zcy/kong/luarocks/lib/lua/5.1/resty/kong/tls.so'  
        no file '/home1/zcy/kong/openresty/site/lualib/resty.so'  
        no file '/home1/zcy/kong/openresty/lualib/resty.so'  
        no file './resty.so'  
        no file '/usr/local/lib/lua/5.1/resty.so'  
        no file '/home1/zcy/kong/openresty/luajit/lib/lua/5.1/resty.so'  
        no file '/usr/local/lib/lua/5.1/loadall.so'  
        no file '/home1/zcy/.luarocks/lib/lua/5.1/resty.so'  
        no file '/home1/zcy/kong/luarocks/lib/lua/5.1/resty.so'

Run with --v (verbose) or --vv (debug) for more details

**原因**：是kong启动时会在预先设置的路径中加载tls.lua和init.lua模块，而搜索完所有路径都没有发现需要的模块就会报错，可能是在安装过程中依赖的lua模块没有放到对应的路径下。

**解决方法**：使用find命令在根目录下找kong缺失的模块文件（如：find / -name tls.lua），将找到后的模块文件放到kong启动加载时检索的目录下，或使用建立软连接的方式即可。

拷贝https://github.com/Kong/lua-kong-nginx-module里的lualib/resty/kong/tls.lua到  luarocks/share/lua/5.1/resty/kong/tls.lua

## failed to wait for schmeaconsensus:timeout ##

使用kong migrations bootstrap进行初始化的过程中，出现如下所示”failed to wait for schmeaconsensus:timeout”的错误。

**原因**：kong使用的数据库采用的是多台服务器集群部署的方式。在初始化过程中会进行一系列的创建数据库、表、字段等一系列操作，并要在集群之间完成数据的同步一致化。可能网络、磁盘IO等原因，未在设定的时间内完成数据一致化，就会报错。

**解决方法**：kong migrations bootstrap初始化命令后边可以跟一些选项参数，其中--db-timeout选项是用来指定超时时间的，如果不手动指定该选项，默认参数值为60（单位为秒）。因此可以手动指定该选项，并设置一个更长时间的参数。

# 8 命令 #

kong start -c ./kong.conf

kong stop -p ./

# 9 其他问题参考： #

[https://www.lijiaocn.com/%E9%97%AE%E9%A2%98/2018/09/29/kong-usage-problem-and-solution.html][https_www.lijiaocn.com_E9_97_AE_E9_A2_98_2018_09_29_kong-usage-problem-and-solution.html]

参考：

[https://blog.csdn.net/lijiaocn/article/details/83004672][https_blog.csdn.net_lijiaocn_article_details_83004672]

[https://promagic.cn/apiwangguankongshiyongjiaochengyinginxopenrestyhekongdejibengainianyushiyongfangfa.shtml][https_promagic.cn_apiwangguankongshiyongjiaochengyinginxopenrestyhekongdejibengainianyushiyongfangfa.shtml]

[https://bbs.huaweicloud.com/forum/thread-39375-1-1.html][https_bbs.huaweicloud.com_forum_thread-39375-1-1.html]

# 请我喝咖啡 #

**如果觉得文章写得不错，能对你有帮助，可以扫描我的微信二维码请我喝咖啡哦～~哈哈~~**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lhbmd5YW5neWU_size_16_color_FFFFFF_t_70][]

[Nginx]: http://nginx.org/
[OpenRestry]: https://openresty.org/en/
[Kong]: https://konghq.com/kong-community-edition/
[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jYW1vLmdpdGh1YnVzZXJjb250ZW50LmNvbS9kNGQwZGNiMjJjMjIzZGIwYmYyZTMwMWFhYjBkZGRiMzAxNWYxNzI5LzY4NzQ3NDcwNzMzYTJmMmY2YjZmNmU2NzY4NzEyZTYzNmY2ZDJmNzc3MDJkNjM2ZjZlNzQ2NTZlNzQyZjc1NzA2YzZmNjE2NDczMmYzMjMwMzEzODJmMzAzNTJmNmI2ZjZlNjcyZDYyNjU2ZTY1NjY2OTc0NzMyZDY3Njk3NDY4NzU2MjJkNzI2NTYxNjQ2ZDY1MmU3MDZlNjc?x-oss-process=image/format,png
[https_github.com_Kong_kong]: https://github.com/Kong/kong
[https_docs.konghq.com_install_source]: https://docs.konghq.com/install/source/
[https_www.openssl.org_source]: https://www.openssl.org/source/
[https_github.com_Kong_lua-kong-nginx-module]: https://github.com/Kong/lua-kong-nginx-module
[https_openresty.org_en_download.html]: https://openresty.org/en/download.html
[https_www.lijiaocn.com_E9_97_AE_E9_A2_98_2018_09_29_kong-usage-problem-and-solution.html]: https://www.lijiaocn.com/%E9%97%AE%E9%A2%98/2018/09/29/kong-usage-problem-and-solution.html
[https_blog.csdn.net_lijiaocn_article_details_83004672]: https://blog.csdn.net/lijiaocn/article/details/83004672
[https_promagic.cn_apiwangguankongshiyongjiaochengyinginxopenrestyhekongdejibengainianyushiyongfangfa.shtml]: https://promagic.cn/apiwangguankongshiyongjiaochengyinginxopenrestyhekongdejibengainianyushiyongfangfa.shtml
[https_bbs.huaweicloud.com_forum_thread-39375-1-1.html]: https://bbs.huaweicloud.com/forum/thread-39375-1-1.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lhbmd5YW5neWU_size_16_color_FFFFFF_t_70]: /images/20230528/bfd947cc4a6c4211b9eca2a58029d4d2.png