API网关——Kong实践分享

概述

什么是Kong

Kong是一个在Nginx中运行的Lua应用程序,可以通过lua-nginx模块实现,Kong不是用这个模块编译Nginx,而是与OpenRestry一起发布,OpenRestry已经包含了lua-nginx-module,OpenRestry是Nginx的一组扩展功能模块。

为什么是Kong

Kong是一个Api Gateway,通过插件的形式提供负载均衡,日志记录,身份验证,速率限制,转换等功能。

Kong可以很轻松扩展功能,模块化,可以运行在任何基础设施上。

API网关——Kong实践分享_第1张图片

术语

Route:是请求的转发规则,按照Hostname和PATH,将请求转发给Service。

Services:是多个Upstream的集合,是Route的转发目标。

Consumer:是API的用户,里面记录用户的一些信息。

Plugin:是插件,plugin可以是全局的,绑定到Service,绑定到Router,绑定到Consumer。

Certificate:是https证书。

Sni:是域名与Certificate的绑定,指定了一个域名对应的https证书。

Upstream:是负载均衡策略。

Target:是最终处理请求的Backend服务。

特性

  • 动态负载均衡
  • 基于散列的负载均衡
  • 断路器
  • 健康检查
  • Websockets
  • OAuth2.0
  • 日志记录

安全性

Syslog

监控

转发代理

认证

速率限制

故障检测和恢复

……

更多详情参考:https://docs.konghq.com/hub/

开源/企业对比

API网关——Kong实践分享_第2张图片

API网关——Kong实践分享_第3张图片

API网关——Kong实践分享_第4张图片

架构

架构图

API网关——Kong实践分享_第5张图片

1.1版本以后支持无db模式

执行流程

加入kong后,每个客户端对API的请求将首先到达Kong,然后被代理到最终API,在请求和响应之间,Kong将执行任何已安装的插件,扩展API功能集,Kong有效的成为每个API的入口点。

部署

Kong支持在任何基础设施上运行,支持docker、packages、vagrant、Homebrew、CloudFormation、AWS、Azure、Kubernetes等。

本次部署基于package方式,部署软件版本。

软件 版本
Kong 1.0.3
Postgresql 9.6
Kong-dashboard 3.5.0

01部署Postgresql

docker run 
--
name postgres 
-
e POSTGRES_PASSWORD
=
123456
 
-
p 
5432
:
5432
 
-
d postgres
:
9.6

02创建用户及数据库

  • 登陆

    psql
    -
    U postgres
    -
    h
    10.20
    .
    1.190

    -
    p
    5432

  • 创建用户

    create user kong
    with

    password 


    kong
    ’;

  • 创建数据库

    create database kong owner kong
    ;

  • 退出控制台

q

03下载安装包

wget:https://kong.bintray.com/kong...:kong-1.0.3.el7.noarch.rpm

04安装配置

  • 安装rpm

    yum install kong
    -
    1.0
    .
    3.el7.noarch
    .
    rpm

  • 拷贝配置

    cp
    /
    etc
    /
    kong
    /
    kong
    .
    conf
    .
    default

    /
    etc
    /
    kong
    /
    kong
    .
    conf

  • 配置

    admin_listen
    =

    0.0
    .
    0.0
    :
    8001
    ,

    0.0
    .
    0.0
    :
    8444

    ssl
    

    pg_host
    =

    10.20
    .
    1.190

    pg_port
    =

    5432

    pg_user
    =

    kong
    

    pg_password
    =

    kong
    

    pg_database
    =

    kong
    

保存并退出。

05启动kong

  • 数据库迁移,初始化表

    kong migrations bootstrap
    -
    c
    /
    etc
    /
    kong
    /
    kong
    .
    conf

    vv

  • 启动

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

06部署kong-dashboard

dashboard目前只支持kong版本1.0.3,kong最新版本不支持,使用pgbi/kong-dashboard镜像

  • 启动dashboard

    docker run
    -
    p
    8888
    :
    8080

    pgbi

    /
    kong
    -

    dashboard start

    kong
    -
    url http
    :
    //10.20.1.190:8001

使用

01upstream

API网关——Kong实践分享_第6张图片

02target

API网关——Kong实践分享_第7张图片

03service

API网关——Kong实践分享_第8张图片

04routers

API网关——Kong实践分享_第9张图片

05验证

API网关——Kong实践分享_第10张图片

06插件

1.Base-auth

创建consumer

API网关——Kong实践分享_第11张图片

创建Basic-auth-credential

API网关——Kong实践分享_第12张图片

服务开启Basic-auth

图片描述

验证

未加用户信息,没权限,效果如下:

API网关——Kong实践分享_第13张图片

加入用户信息后,效果如下:

API网关——Kong实践分享_第14张图片

集成

01Dns SRV

Kong利用Dns轮询访问后端应用。

1.架构图

API网关——Kong实践分享_第15张图片

2.检查服务域名

使用Dns做服务发现,查看boms-user-service服务如下:

 dig @10.20.11.118 -p 8600 boms-user-service.service.dc1.consul SRV

API网关——Kong实践分享_第16张图片

含义解释:

API网关——Kong实践分享_第17张图片

调用服务域名boms-user-service.service.dc1.consul,通过dns解析找到实例ip+port,如上例中10.20.11.118:8081。

3.修改kong配置

vim 编辑kong.conf,增加:

dns_resolver
:
 
127.0
.
0.1
:
8600


4.kong中使用

在kong中手动增加一个service,host填入服务域名,增加router,即可转发。

5.总结

需要手动在kong中创建服务,并且仅适用consul注册中心。

https://github.com/faizalprib...

02Agent 轮询

1.架构图

API网关——Kong实践分享_第18张图片

agent负责监听注册中心,动态调用kong admin API创建upstream、target、service、router等资源。

用户通过boms平台调用admin API修改router信息,实现服务转发功能,在此数据基础之上在启用插件,丰富功能。

开发

01命令行

https://docs.konghq.com/1.0.x...

02Admin API

https://docs.konghq.com/1.0.x...

例如:

API网关——Kong实践分享_第19张图片

03插件开发

https://docs.konghq.com/1.0.x... 插件开发工具包。

参考

https://docs.konghq.com Kong官方文档

https://docs.konghq.com/hub/k... 插件文档

https://www.lijiaocn.com/%E6%... dns-srv 详解

https://github.com/faizalprib...

https://github.com/YeautyYE/n...

https://github.com/quancheng-...

你可能感兴趣的:(kong)