今天尝试安装KONG 具体安装过程不难网上资料很多。其中部分命令包括：

启动命令

kong start -c /etc/kong/kong.conf --vv    vv是DEBUG模式  -V是启动详情模式

 

 

/etc/kong/kong.conf 里面监听端口的语句需要把注释去掉。

增加一个转发API 触发example.com 直接转到baidu.com

curl -i -X POST --url http://URL:8001/apis/ --data 'name=example-api' --data 'hosts=example.com' --data 'upstream_url=http://baidu.com'

 

 

kong:api

kong:server

kong:route

kong:

Kong
环境
ubuntu 18.04 Bionic
安装软件
软件列表

PostgreSQL
Kong
kong-dashboard

Kong官方安装步骤
本文以官方安装步骤为主线，适当补充了些内容。

Ubuntu Installation
PostgreSQL
官方安装步骤PostgreSQL: Linux downloads (Ubuntu)
apt-get install postgresql-10

软件不大，解压后20MB左右。
PostgreSQL入门
kong官方安装步骤的第二步需要配置PostgreSQL
参考PostgreSQL新手入门文中的第一种方法操作。
其中创建数据库用户kong，密码为kong，一个新的用户数据库kong并指定其为kong的SQL语句为：
CREATE USER kong WITH PASSWORD 'kong'; CREATE DATABASE kong OWNER kong;

Kong
使用apt安装
点击进入kong / kong-community-edition-deb我们可以发现使用apt安装的步骤。
添加密钥
curl 'https://bintray.com/user/downloadSubjectPublicKey?username=bintray' | sudo apt-key add -

添加软件源
点击*SET ME UP!*后，我们发现两种添加软件源的方法

{distribution}是指系统发行版本，ubuntu 18.04是bionic，可以通过运行lsb_release -cs获得，{components}一般填写成main。


使用命令行
echo "deb https://kong.bintray.com/kong-community-edition-deb {distribution} {components}" | sudo tee -a /etc/apt/sources.list

懒人直接运行
echo "deb https://kong.bintray.com/kong-community-edition-deb $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list



使用GUI界面
deb https://kong.bintray.com/kong-community-edition-deb {distribution} {components}



安装相应的软件
官方安装步骤的第1步的第三条命令修改成下：
sudo apt install kong-community-edition

安装kong-community-edition下载速度会比较慢，建议翻墙安装。
配置
Configuration loading
Kong的默认配置文件在/etc/kong/kong.conf.default，如果我们通过官方软件包安装Kong。
如果我们要开始配置Kong，可以复制此文件：

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

如果配置中的有的值被注释掉，Kong将使用相应的默认值。启动时，Kong会查找可能包含配置文件的多个默认位置：
/etc/kong/kong.conf
/etc/kong.conf

可以使用-c指定配置文件路径
一般我们需要关注的配置值有：
pg_host = 127.0.0.1             # The PostgreSQL host to connect to.
pg_port = 5432                  # The port to connect to.
pg_user = kong                  # The username to authenticate if required.
pg_password =               # The password to authenticate if required.
pg_database = kong

其他注意事项
可以使用-v或者-vv看到执行详情。
配置服务
官方Configuring a Service
我在运行migrations和start命令时需要sudo
kong-dashboard
其实前面已经安装的可以正常用了。kong-dashboard是web ui。
好像有兼容问题。弃用了。
安装kong-dashboard
然后按照PGBI/kong-dashboard: Dashboard for managing Kong gateway中说明的
# Install Kong Dashboard
npm install -g kong-dashboard

# Start Kong Dashboard
kong-dashboard start --kong-url http://kong:8001

其中的kong:8001换成对应的URL和端口。
kong-dashboard的访问端口默认开在8080
konga
pantsel/konga: More than just another GUI to Kong Admin API
nodejs
Debian and Ubuntu based Linux distributions, Enterprise Linux/Fedora and Snap packages找到了Official Node.js binary distributions，根据其中的说明，ubuntu用户安装Node.js v11.x需要运行
curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt-get install -y nodejs

安装konga
git clone https://github.com/pantsel/konga.git
cd konga
npm install

安装的时候竟然编译和下载起来了，挺费时间的，有些后悔安装konga了
配置
网上的教程中通常会在konga根目录/local/local.js继续配置数据库（用来供konga使用的，和kong没啥关系）。官方似乎更推荐在konga根目录/.env中配置。
我根据postgresql的官方文档33.1.1. Connection Strings配置了下，报错说public.konga_users不存在，我又仔细看了下konga的官方介绍，发现了

Konga is bundled with It’s own persistence mechanism for storing users and configuration.


A local persistent object store is used by default, which works great as a bundled, starter database (with the strict caveat that it is for non-production use only).

换句话说，如果你不在生产环境下使用的话，不用配置数据库，也不要弄konga根目录/.env，直接在konga根目录下npm start然后在http://localhost:1337打开使用就行了。
注册个账户，指定下kong admin api，ok啦。
使用
和使用kong的admin api大同小异，好处是在于有GUI界面了，更为直观。
SERVICES
点击ADD NEW SERVICE添加从kong到web api的转发规则。
弹出的对话框中的Url是protocol,host,port,path的Shorthand（速记，就是将几个参数整合在一块）
ROUTES
我们需要点击SERVICES中的SERVICE才能添加ROUTE。点击服务内Routes后点击ADD ROUTE，里面值得留意的选项有Strip Path和Preserve Host
Strip Path
是否去除path的功能，如果设为No的话，kong向web api的url是service的path + route中匹配的path，否则是service的path
Preserve Host

When matching a Route via one of the hosts domain names, use the request Host header in the upstream request headers. By default set to false, and the upstream Host header will be that of the Service’s host

是否保留请求头中的Host字段。如果设为Yes，kong向web api的请求中会保留Host字段（好像是这样的）
参考
apigateway-kong(一)简介及部署
Kong Api 初体验
ubuntu部署kong以及安装Kong Dashboard

1、简介
Kong 是一个企业级服务网关，底层是使用lua语言，整合Nginx 实现了强大的服务转发，路由，验证功能，
1.2 官方描述
Kong was originally built at Mashape to secure, manage and extend over 15,000 APIs & Microservices for its API Marketplace, which generates billions of requests per month for over 200,000 developers. Today Kong is used in mission critical deployments at small and large organizations.
Kong是一个Mashape开源的高性能高可用的API网关和API服务管理层，基于OpenResty,进行API管理，并提供了插件实现了API的AOP功能。
Kong在Mashape管理了15000+个API。为20+万开发者提供每月数十亿的请求支持。
Kong是基于OPenRestry，而OpenRestry又是对Nginx的二次封装，所以很多配置项和Nginx类似。
1.2 特点
可扩展性： Kong通过简单的增加机器节点，可以很容易的水平扩展。
模块化：Kong通过插件的方式扩展，插件可以很容易通过一个RESTful管理API来配置。
可以运行在任何基础架构：Kong 可以处处运行，包括云、本地环境或者混合环境、单个或者多个数据中心等
1.3 技术架构
从技术架构图可以看出、kong 是一款流量网关开源的产品
1.4 工作流程
Kong 是在客户端和(微)服务间转发API通信的PAI网关、通过插件可以扩展功能。
一旦kon运行起来、每个客户端对API的请求将先到达Kong 、然后被代理到最终的API上。
在请求和响应之间，Kong将执行任何安装的插件，扩展API 的功能集。其有效的成为每个API 的请求入口。
1.5 主要组件介绍
Kong server: 基于Nginx服务器，用来接受API请求的。
Apache Cassandra & PostgreSQL : 用来存储操作数据的。
可以通过增加Kong Server 机器来对Kong服务进行水平扩展，通过前置的负载均衡器向这些服务器分发请求，根据官方文档描述，两个存储节点(Cassandra)就足以支撑绝大多数情况，但如果网络非常拥挤，可以考虑适当的增加更多的节点。
对于开源社区来说，Kong 最吸引人的地方在于可以通过插件扩展已有的功能，这些插件在API请求响应循环的生命周期中被执行。
总结： Kong 就是一个针对Nginx管理系统，并提供了很多关于API网关功能的Nginx扩展
1.6 插件介绍
Kong 插件使用 Lua 脚本编写。
在官方文档中，我们可以获取全部插件，其中部分插件是需要收费的只有企业版才可以使用。
要玩转Kong, 关键在于它提供的插件。有免费、有收费、还有社区提供的，并且支持自定义。现阶段提供有8类插件
身份验证
权限安全
流量控制
Serverless
分析与监控
数据转换
日志信息
部署发布

个人博客纯净版：https://www.fangzhipeng.com/%E6%9E%B6%E6%9E%84/2017/09/17/kong-api-gateway.html
Kong是一个可扩展的开源API层（也称为API网关或API中间件）。 Kong运行在任何RESTful API的前面，并通过插件扩展，它们提供超出核心平台的额外功能和服务。

Kong最初是在Mashape建立的，用于为其API Marketplace提供超过15,000个API和Microservices，并为超过20万的开发者每月生成数十亿个请求。 今天，Kong被用于小型和大型组织的关键任务部署
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-avVv8VY9-1570074828050)(https://getkong.org/assets/images/docs/kong-architecture.jpg)]

使用的软件
Unbuntu 虚拟机（有自己的服务器更好）
PostgreSQL
kong
kong-dashboard
docker
spring boot
安装 PostgreSQL
kong 需要使用到数据库，目前支持PostgreSQL和Cassandran ,我选择大象数据库，安装过程省略，可以参考这篇文章。

http://www.ruanyifeng.com/blog/2013/12/getting_started_with_postgresql.html
安装完后建一个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到这个文件的目录：
$ sudo apt-get update
$ sudo apt-get install openssl libpcre3 procps perl
$ 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

配置文件：
/etc/kong/kong.conf
/etc/kong.conf


打开配置文件，里面可以修改很多配置，修改数据库连接，用户名、密码
pg_host = 127.0.0.1             # The PostgreSQL host to connect to.
pg_port = 5432                  # The port to connect to.
pg_user = kong                  # The username to authenticate if required.
pg_password = kong              # The password to authenticate if required.
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启动镜像
# Start Kong Dashboard  8080端口启动
docker run -d -p 8080:8080 pgbi/kong-dashboard:v2

# Start Kong Dashboard on a custom port  指定一个端口启动
docker run -d -p [port]:8080 pgbi/kong-dashboard:v2

# Start Kong Dashboard with basic auth  8080端口启动，带一个用户基本认证
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，就可以进入了。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-iSyrzSdW-1570074828052)(http://fangzhipeng.oss-cn-hangzhou.aliyuncs.com/blog/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20170830111958.png?x-oss-process=style/caijai)]
在kong管理界面创建一个api接口：
填写相关的参数即可，创建完成后如下：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gYXq4fTJ-1570074828054)(http://fangzhipeng.oss-cn-hangzhou.aliyuncs.com/blog/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20170830112038.png?x-oss-process=style/caijai)]
在浏览器上访问：http://192.168.86.128:8000/hi

hi forezp,i am from port:8762

添加api限流插件,一个ip一分钟10次。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-edRMFckb-1570074828054)(http://fangzhipeng.oss-cn-hangzhou.aliyuncs.com/blog/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20170830112602.png?x-oss-process=style/caijai)]
访问超过10次后，会拒绝访问。
添加file-log的插件,文件存放目录为/temp/file.log  ：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fqqcwDcH-1570074828055)(http://fangzhipeng.oss-cn-hangzhou.aliyuncs.com/blog/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20170830114620.png?x-oss-process=style/caijai)]
再次访问：http://192.168.86.128:8000/hi
可以在打开/temp/file.log看见里面的日志信息。
kong 支持了20中插件，插件地址：https://getkong.org/plugins/
参考资料
https://getkong.org/about/
http://www.cnblogs.com/SummerinShire/category/861287.html
http://www.jianshu.com/p/f9a2210f6722
https://yq.aliyun.com/articles/63180
http://www.ruanyifeng.com/blog/2013/12/getting_started_with_postgresql.html
更多阅读
史上最简单的 SpringCloud 教程汇总
SpringBoot教程汇总
Java面试题系列汇总

    

        

        扫码关注公众号有惊喜
    
    

        （转载本站文章请注明作者和出处 方志朋的博客）