HTTP API 网关选择之一 Kong 介绍

Kong是Mashape开源的高性能高可用API网关和API服务管理层。它基于OpenResty,进行API管理,并提供了插件实现API的AOP。Kong在Mashape 管理了超过15,000 个API,为200,000开发者提供了每月数十亿的请求支持。本文将从架构、API管理、插件三个层面介绍Kong。

架构

按照康威定律,我们系统架构会拆的很散,系统由一堆服务组成,如下图所示:

《HTTP API 网关选择之一 Kong 介绍》如在访问库存服务、优惠券服务、价格服务时之前都会做一些特殊处理,如限流、缓存、日志、请求统计。而这些处理几乎是所有服务都需要的,这不就是我们常说的AOP嘛,当我们服务多起来的时候,应该将这些通用处理集中到一个地方进行管理,如下图所示:

《HTTP API 网关选择之一 Kong 介绍》

即通过Kong统一管理通用功能。

Kong的安装请参考官网示例。Kong整体架构如下所示:

《HTTP API 网关选择之一 Kong 介绍》

  1. Kong核心基于OpenResty构建,实现了请求/响应的Lua处理化;

  2. Kong插件拦截请求/响应,如果接触过Java Servlet,等价于拦截器,实现请求/响应的AOP处理;

  3. Kong Restful 管理API提供了API/API消费者/插件的管理;

  4. 数据中心用于存储Kong集群节点信息、API、消费者、插件等信息,目前提供了PostgreSQL和Cassandra支持,如果需要高可用建议使用Cassandra;

  5. dnsmasq用于提供给Nginx DNS解析功能;

  6. Kong集群中的节点通过gossip协议自动发现其他节点,当通过一个Kong节点的管理API进行一些变更时也会通知其他节点。每个Kong节点的配置信息是会缓存的,如插件,那么当在某一个Kong节点修改了插件配置时,需要通知其他节点配置的变更。

API/API消费者/插件管理

Kong的整体流程架构如下图所示:

《HTTP API 网关选择之一 Kong 介绍》

1、添加API服务

首先我们需要通过Kong管理API向Kong注册API服务,如下所示:

curl –I –X POST \

  –url http://kong:8001/apis/ \

  –data ‘name=queryStockService’\

  –data ‘upstream_url=http://stock.jd.local/’\

  –data ‘request_host=api.jd.com’

  –data ‘request_path=queryStock’

 

向Kong添加了一个API,全局唯一名字为queryStockService,当我们访问api.jd.com/queryStock时会upstream到stock.jd.local/queryStock处理,这不就是Nginx反向代理的功能,Kong实现了API的动态添加。

 

2、添加API消费者

我们的API中有些是公开的,所有人都可以访问,而有些API是私有的,只有授权才能访问。在开放平台中,只有授权的开发者才能访问API,且有些高级API是只针对部分开发者可用,还有如对不同开发者有不同的API调用次数限制,等等。在这些非公开场景下,需要有一个API消费者。

curl -i -X POST \

  –url http://kong:8001/consumers/ \

  –data “username=zhangkaitao”\

 

其会生成一个consumer_id “e5da92dd-fbe8-4031-bebf-34c741e209b1”,添加插件章节会用到该ID。

 

3、添加插件

插件可以是全局的,也可以是局部的。如限流插件,我们可以配置为全局限流。目前支持:所有API和所有消费者、所有API和特定消费者、所有消费者和特定API、特定消费者和特定API。

 

为queryStockService添加50次/秒的限流。特定API和所有消费者配置。

curl -X POSThttp://kong:8001/apis/queryStockService/plugins \

    –data “name=rate-limiting”\

    –data “config.second=50”

目前Kong的限流实现是基于计数器,默认是本地限流,可以配置为如使用Redis,实现集群限流。

 

为queryStockService添加密钥身份认证。

curl -i -X POST \

  –url http://kong:8001/apis/queryStockService/plugins/ \

  –data ‘name=key-auth’

 

为消费者添加秘钥。

curl -i -X POST \

  –url http://kong:8001/consumers/zhangkaitao/key-auth/\

  –data ‘key=myKey’

 

通过秘钥访问API。

curl -i -X GET \

  –url http://api.jd.com/queryStock \

  –header “Host: api.jd.com”\

  –header “apikey: myKey”

 

特定API和特定消费者限流,需要配合身份认证模块。

curl -X POST http://kong:8001/apis/abc/plugins \

–data “name=rate-limiting”\

    –data “consumer_id=e5da92dd-fbe8-4031-bebf-34c741e209b1″\

    –data “config.second=1”

 

到此添加API、添加API消费、添加API插件就介绍完了。更多API管理请扫描如下二维码学习。

《HTTP API 网关选择之一 Kong 介绍》

 

更多插件配置学习请扫描如下二维码学习。

《HTTP API 网关选择之一 Kong 介绍》

 

Kong默认插件

身份认证:Kong提供了Basic Authentication、Key authentication、OAuth2.0 authentication、HMAC authentication、JWT、LDAP authentication认证实现。

安全:ACL(访问控制)、CORS(跨域资源共享)、动态SSL、IP限制、爬虫检测实现。

流量控制:请求限流(基于请求计数限流)、上游响应限流(根据upstream响应计数限流)、请求大小限制。限流支持本地、Redis和集群限流模式。

分析监控:Galileo(记录请求和响应数据,实现API分析)、Datadog(记录API Metric如请求次数、请求大小、响应状态和延迟,可视化API Metric)、Runscope(记录请求和响应数据,实现API性能测试和监控)。

转换:请求转换(在转发到upstream之前修改请求)、响应转换(在upstream响应返回给客户端之前修改响应)。

日志:TCP、UDP、HTTP、File、Syslog、StatsD、Loggly等。

 

也可以开发自己的插件,如缓存等。

总结

Kong作为API网关提供了API管理功能,及围绕API管理实现了一些默认的插件,另外还具备集群水平扩展能力,从而提升整体吞吐量。Kong本身是基于OpenResty,可以在现有Kong的基础上进行一些扩展,从而实现更复杂的特性。

 

有一些特性Kong默认是缺失的,如API级别的超时、重试、fallback策略、缓存、API聚合、ABTest等,这些需要开发者自己定制和扩展。

 

如果你要做开放平台,你要做HTTP API网关,Kong是您的一个选择。

事情太多,最近原创的文章有点少。后续有时间会介绍Kong整体流程的实现。更多Kong的介绍请扫描如下二维码查看Kong文档进行学习。

《HTTP API 网关选择之一 Kong 介绍》

=========阅读扩展=========

京东商品详情页服务闭环实践

使用Nginx+Lua(OpenResty)开发高性能Web应用

应用数据静态化架构高性能单页Web应用

应用多级缓存模式支撑海量读服务

小模块解决大痛点—nginx+lua托底数据解决方案

构建需求响应式亿级商品详情页

    原文作者:HTTP
    原文地址: https://juejin.im/entry/58b2e2858d6d810058665aa3
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞