kong网关调研文档（走世界翻译官）

kong简介：

Kong是一款基于Nginx_Lua模块写的高可用，易扩展由Mashape公司开源的API Gateway项目。由于Kong是基于Nginx的，所以可以水平扩展多个Kong服务器，通过前置的负载均衡配置把请求均匀地分发到各个Server，来应对大批量的网络请求。---官方描述说的比较牵强，不容易理解其含义，通俗理解就是集合插件的API网关第三方，类似于集成应用。webmin.wdcp.phpstudy--等。

在我们玩转kong之前，我们先了解一下api网关。

API 网关，即API Gateway，是大型分布式系统中，为了保护内部服务而设计的一道屏障，可以提供高性能、高可用的 API托管服务，从而帮助服务的开发者便捷地对外提供服务，而不用考虑安全控制、流量控制、审计日志等问题，统一在网关层将安全认证，流量控制，审计日志，黑白名单等实现。网关的下一层，是内部服务，内部服务只需开发和关注具体业务相关的实现。网关可以提供API发布、管理、维护等主要功能。开发者只需要简单的配置操作即可把自己开发的服务发布出去，同时置于网关的保护之下。

Kong主要有三个组件：

Kong Server ：基于nginx的服务器，用来接收API请求。
Apache Cassandra/PostgreSQL ：用来存储操作数据。
Kong dashboard：官方推荐UI管理工具，当然，也可以使用 restfull 方式管理admin api。

Kong采用插件机制进行功能定制，插件集（可以是0或n个）在API请求响应循环的生命周期中被执行。插件使用Lua编写，目前已有几个基础功能：HTTP基本认证、密钥认证、CORS（ Cross-origin Resource Sharing，跨域资源共享）、TCP、UDP、文件日志、API请求限流、请求转发以及nginx监控。

Kong 官网：https://getkong.org/ 插件介绍，帮助文档等。

Kong 源码：https://github.com/Mashape/kong

Kong UI管理工具：https://github.com/PGBI/kong-dashboard 浏览器UI管理工具

Kong 桌面管理工具：https://github.com/ajaysreedhar/kongdash 有linux版本，windows版本，mac版本。

社区资源和工具

安装KONG的方式

可以选择不同的方式进行安装 ->重要

Kong Docker: A Dockerfile for running Kong in Docker.
Kong Packages: Pre-built packages for Debian, Red Hat, and OS X distributions (shipped with each release).
Kong Vagrant: A Vagrantfile for provisioning a development ready environment for Kong.
Kong Homebrew: Homebrew Formula for Kong.
Kong CloudFormation: Kong in a 1-click deployment for AWS EC2
Kong AWS AMI: Kong AMI on the AWS Marketplace.
Kong on Microsoft Azure: Run Kong using Azure Resource Manager.
Kong on Heroku: Deploy Kong on Heroku in one click.
Kong and Instaclustr: Let Instaclustr manage your Cassandra cluster.

第三方管理维护工具

Ansible role for Kong on Ubuntu
Biplane: declarative configuration in Crystal Crystal语言版本声明式配置管理工具，利用配置，一键批量执行。
Bonobo: key management (with Mashery migration scripts)
Chef cookbook
Django Kong Admin: Admin UI in Python Python版本UI界面管理工具
Jungle: Admin UI in JavaScript JS版本UI界面管理工具
Kong Dashboard: Admin UI in JavaScript JS版本UI界面管理工具
Kong for CanopyCloud
Kong image waiting for Cassandra
Kong image for Tutum
Kong-UI: Admin UI in JavaScript JS版本UI界面管理工具
Konga: CLI Admin tool in JavaScript JS客户端管理工具
Kongfig: Declarative configuration in JavaScript JS语言版本声明式配置管理工具，利用配置，一键批量执行。
Kongfig on Puppet Forge
Puppet recipe
Puppet module on Puppet Forge
Python-Kong: Admin client library for Python Python客户端。
.NET-Kong: Admin client library for .NET .NET客户端。
kong-java-client: Admin client library for Java java客户端

资源

以上是官方知识汇总以及个人总结经验，如有不明白可发留言或邮件探讨。

以下是基于本公司微服务api-gateway针对使用kong调研文档，详细如下

ong 是一个现成的 api gateway 的解决方案，它在 nginx 上进行了开发。

api gateway 的实现方式有很多种，比如说 JVM 上可以用基于NIO 的框架比如Netty，Vertx，Spring Reactor，JOSS Undertow。现在一个比较流程的没有基于 JVM 的就是 NodeJs。其他的还有 Nginx Plus。

以下介绍 Kong 的使用。

3.1 安装 Kong
3.2 加入 API

3.1 安装 Kong

参考：https://getkong.org/install/ ，里面写得比较详细了，但是要预先安装一个 Cassandra 数据库（介绍：http://cassandra.apache.org/）。安装之后，Kong 项目会监控两个端口，一个是 8000，一个是 8001。 8000端口是可以给用户访问，就是说用户发送请求先到 Kong 项目的 8000 端口，然后Kong 项目帮你转到你的后端应用api。 8001 端口是管理端口，比如说，管理员可以通过 8001端口来得到你加入过的 api。

3.2 加入 API

参考文档：https://getkong.org/docs/0.5.x/admin-api/ ，里面介绍了 api 的管理，包括增删查改。下面介绍我第一次使用时还有有些不清楚的点：

3.2.1 列出所加过的 api

curl localhost:8001/apis/

3.2.2 加入 api

单个加入：

curl -i -X POST --url http://localhost:8001/apis/ --data 'upstream_url=http://camp.uats.cc' --data 'request_path=login'

上面这段命令表示：

--url：http://localhost:8001/apis/ 固定的，加入 api 就得写这个，表示给 kong管理。
upstream_url：表示我们的网站。相当于一个请求前缀。
request_path：就是具体我们的 api。

利用request_host 部署全部的 api：

curl -i -X POST --url http://localhost:8001/apis/ --data 'upstream_url=http://183.131.76.124:4100/' --data 'request_host=183.131.76.122'

3.2.3 删除 api

curl -i -X DELETE localhost:8001/apis/00f90ca9-cf2d-4830-c842-3b90f6cd08af

后面这个串表示加入的api的 id。