Kong

2016年3月18日 (五) 00:01的版本

Kong 是一个基于Nginx构建的Microservices和API开源(Apache v2)管理层。

安装

先安装好 LuaRocks 和 LuaJIT

brew tap mashape/kong
brew install kong
kong --help
kong start
curl 127.0.0.1:8001
http://localhost:8001
http://localhost:8001/status/
http://localhost:8001/consumers/
http://localhost:8001/apis/
http://localhost:8001/apis/mockbin
http://localhost:8001/plugins
http://localhost:8001/plugins/enabled
http://localhost:8001/apis/mockbin/plugins
http://localhost:8001/plugins/schema/oauth2

Cassandra

使用测试数据库，/etc/kong/kong.yml，类似：

database: cassandra
cassandra:
  contact_points:
    - "ec2-54-172-252-55.compute-1.amazonaws.com:35049"

Docker

Pull官方镜像

$ docker pull cassandra:2.2.4
$ docker pull mashape/kong

启动Cassandra

docker run -p 9042:9042 -d --name cassandra cassandra:2.2.4

启动Kong

$ docker run -d --name kong \
           --link cassandra:cassandra \
           -p 8000:8000 \
           -p 8443:8443 \
           -p 8001:8001 \
           -p 7946:7946 \
           -p 7946:7946/udp \
           mashape/kong

运行

$ curl http://127.0.0.1:8001

Vagrant

$ git clone https://github.com/Mashape/kong
cd kong
$ git checkout next
$ cd ..
$ git clone https://github.com/Mashape/kong-vagrant
$ cd kong-vagrant/
$ KONG_PATH=/Users/huihoo/kong vagrant up
$ vagrant ssh
$ cd /kong
$ sudo make dev
$ kong start -c kong_DEVELOPMENT.yml
$ curl http://localhost:8001

组件

Kong可与两种不同的组件协同工作：

• Nginx: Kong使用经过修改的Nginx web服务器作为代理服务器，负责处理API请求。
• Apache Cassandra: 用作数据存储(datastore)服务器，负载存储来自Kong操作的数据。

相关Lua模块组件：

• lua-nginx-module
• lua-cassandra

相关项目

• Mockbin
• API Embed
• Unirest
• Guardian JS
• OAuth Bible
• Public APIs
• serf 服务编排和管理工具，Go语言编写。
• dnsmasq

管理仪表盘

Kong Dashboard

npm install -g kong-dashboard
kong-dashboard start
http://localhost:8080

JUNGLE

git clone https://github.com/rsdevigo/jungle
cd jungle
npm install
bower install
vim modules/core/config/core.client.constants.js
grunt && grunt serve
http://localhost:3000

常见问题

/usr/local/bin/luajit: not found

git clone http://luajit.org/git/luajit-2.0.git
cd luajit-2.0
git pull
make 
sudo make install

error loading module 'lfs' from file '/usr/local/lib/lua/5.1/lfs.so':

sudo luarocks install luafilesystem

Can't find serf

https://www.serfdom.io/downloads.html

Kong can't find nginx #610

https://github.com/Mashape/kong/blob/master/kong/cli/services/nginx.lua
sudo find / -type f -name "nginx"

error loading module 'lua_uuid'

sudo luarocks install lua_uuid

用户

• Mashape世界上规模最大的API市场 PublicAPIs

图集

• 

  遗留架构

• 

  Kong架构

• 

  Kong集群

• 

  仪表盘APIs

• 

  仪表盘Consumers

• 

  仪表盘Plugins

• 

  JUNGLE

链接

• Kong官网
• Kong @ GitHub
• Plugin Development Guide
• Public Lua API Reference
• Cassandra for Kong
• Kongdb - On demand Cassandra database for testing Kong
• Docker distribution for Kong
• How Mashape Manages Over 15,000 APIs & Microservices