Kong安装教程

使用的软件

  • Unbuntu 虚拟机(有自己的服务器更好)
  • PostgreSQL
  • kong
  • kong-dashboard
  • docker
  • spring boot

安装 PostgreSQL

kong 需要使用到数据库,目前支持PostgreSQL和Cassandran ,我选择大象数据库,安装过程省略,可以参考这篇文章。 

Ubuntu PostgreSQL安装和配置

安装完后建一个kong的用户、密码为kong、建一个kong 数据库:

CREATE USER kong; CREATE DATABASE kong OWNER kong;

安装kong

下载kong的源文件,下载地址:https://getkong.org/install/ubuntu/

下载完成之后会有这样一个文件kong-community-edition-0.11.0.*.deb,cd到这个文件的目录:

  1.   $ sudo apt-get update
  2.   $ sudo apt-get install openssl libpcre3 procps perl
  3.   $ sudo dpkg -i kong-community-edition-0.11.0.*.deb

配置kong

配置文档在这里:

https://getkong.org/docs/0.9.x/configuration/

复制配置文件:

$ cp /etc/kong/kong.conf.default /etc/kong/kong.conf

配置文件:

  1.   /etc/kong/kong.conf
  2.   /etc/kong.conf

打开配置文件,里面可以修改很多配置,修改数据库连接,用户名、密码

  1.   pg_host = 127.0.0.1 # The PostgreSQL host to connect to.
  2.   pg_port = 5432 # The port to connect to.
  3.   pg_user = kong # The username to authenticate if required.
  4.   pg_password = kong # The password to authenticate if required.
  5.   pg_database = kong

执行以下整合命令:

$ kong migrations up [-c /path/to/kong.conf]

启动kong :

kong start -c /etc/kong/kong.conf --vv

打开浏览器访问:localhost:8001,浏览器显示了一大串关于kong的json字符串,则启动成功。 
kong管理端口为8001, 监控端口为8000。

管理端口用rest api对api进行操作,文档地址:https://getkong.org/docs/0.8.x/admin-api

安装 kong-dashboard

kong管理端的第三方网页,地址:https://github.com/PGBI/kong-dashboard

支持npm启动,但是没有成功过,直接选择了docker启动。 
要求先安装docker,docker启动镜像

  1.   # Start Kong Dashboard 8080端口启动
  2.   docker run -d -p 8080:8080 pgbi/kong-dashboard:v2
  3.    
  4.   # Start Kong Dashboard on a custom port 指定一个端口启动
  5.   docker run -d -p [port]:8080 pgbi/kong-dashboard:v2
  6.    
  7.   # Start Kong Dashboard with basic auth 8080端口启动,带一个用户基本认证
  8.   docker run -d -p 8080:8080 pgbi/kong-dashboard:v2 -a user=password

演示实例

在电脑上开启一个spring boot 工程有一个api接口为http://10.10.20.187:8762/hi

其实kong管理api有一系列的接口,直接用crul 就可以完成管理,但是有第三个kong-dashboard,我就用了kong-dashboard的管理界面进行操作。

在上一小节启动docker之后,打开网页http://192.168.86.128:8080(我unbuntu虚拟机的host为192.168.86.128),填写kong的管理urlhttp://192.168.86.128:8001,就可以进入了。

Kong安装教程

在kong管理界面创建一个api接口:

填写相关的参数即可,创建完成后如下:

Kong安装教程

在浏览器*问:http://192.168.86.128:8000/hi

hi forezp,i am from port:8762

添加api限流插件,一个ip一分钟10次。

Kong安装教程

访问超过10次后,会拒绝访问。

添加file-log的插件,文件存放目录为/temp/file.log :

Kong安装教程

再次访问:http://192.168.86.128:8000/hi

可以在打开/temp/file.log看见里面的日志信息。

kong 支持了20中插件,插件地址:https://getkong.org/plugins/

上一篇:Kong入门指南 - 使用身份验证保护服务


下一篇:kong golang 插件开发