Apinto网关基于GO语言模块化开发,5分钟极速部署,配置简单、易于维护,支持集群与动态扩容,开箱即用。Apinto除了提供丰富的网关插件外,还提供监控告警、用户角色等扩展应用,同时支持自定义网关插件和可扩展业务应用,满足我们企业的定制化需求。

本文将从Apinto网关的安装部署、功能模块以及Apinto应用三个方面进行说明。

1、安装部署

Apinto部署地址:部署 | APINTO

Apinto Dashboard 部署地址:https://help.apinto.com/docs/dashboard-v2/quick/arrange.html

2、功能模块

API网关 nginx api网关 开源_端系统

 

网关集群由多个Apinto网关节点构成,网关控制台配置各个功能模块,把数据发布到各个网关集群生效。

集群管理:管理各个环境的集群,给集群配置证书、配置并发布该集群下的环境变量、监控并管理集群下各个网关节点、配置管理等。

上游服务:上游管理和服务发现。服务发现支持consul、eureka、nacos注册中心;上游管理是管理所有提供API调用的后端系统,都需要上线到指定的集群才生效;

API管理:支持业务域分组,管理所有后端系统提供的API及其生命周期,根据业务上下线到相应的集群。

应用管理:管理所有调用方,配置请求网关的鉴权,以及支持转发后端的额外参数鉴权,上下线到指定集群生效。

服务治理:针对不同集群配置并上线限流、访问、熔断、灰度、缓存等策略,保障网关集群以及后端系统稳定工作。

扩展应用:提供并支持自定义业务型扩展应用供用户安装使用,业务型应用如:用户角色、监控告警、日志、API文档、开放平台、安全防护、数据分析、调用链、mock、在线调测、安全测试、国密、多协议。

系统管理:配置邮箱,配置告警模板等。

3、Apinto应用

前提条件已经部署好Apinto网关节点群和控制台,并且运行程序,Apinto网关控制台主流程配置如下图所示:

API网关 nginx api网关 开源_API_02

 

主流程有四步,完成这四步就可以试着调用API,看网关能否成功转发API到后端系统。

3.1 配置网关集群

第一步:在浏览器输入控制台访问页面进入控制台页面。

API网关 nginx api网关 开源_开源_03

 

第二步:再点击基础设施菜单,展开后再点击集群管理进入集群管理列表页面,我们直接创建集群,操作如下图所示:

API网关 nginx api网关 开源_字段_04

 

第三步:新建集群如下图所示:

API网关 nginx api网关 开源_字段_05

 

3.2 配置并发布上游服务

第一步:点击上游服务菜单,展开后再点击上游管理进入上游管理列表页面,如下图所示:

API网关 nginx api网关 开源_端系统_06

 

  第二步:点击新建上游,我们以静态节点说明,配置如下图所示:

API网关 nginx api网关 开源_端系统_07

 

  部分字段说明:

字段名称

字段描述

上游名称

上游服务名称不能使用中文,因为系统用它作为该上游服务的唯一标识读取或更新数据

请求协议

后端系统API的协议,支持HTTP/HTTPS

负载算法

多目标节点,支持轮询算法

服务发现

支持静态节点类型和动态服务类型,该项可选值为静态节点、服务发现列表名称数据

目标节点

提供API响应后端系统的主机名/IP+端口号;如果有多个目标节点,则可以通过配置‘权重’来规划每个节点承载的流量比例;目标节点也可以通过引用环境变量,引用的环境变量通过配置格式:{域名/ip}:{port} {weight},多个以‘;’隔开

请求超时时间

网关请求到后端系统的超时时间

  第三步:把刚配置好的上游发布到集群,如下图如示:

API网关 nginx api网关 开源_API网关 nginx_08

 

3.3 配置并发布API

API管理是管理所有上游提供的API生命周期功能,提供按业务域分类管理、添加API、单个或批量API从不同集群上下线等功能。

第一步:点击左侧导航API管理,进入API管理页面:

API网关 nginx api网关 开源_端系统_09

 

第二步:新建API

API网关 nginx api网关 开源_API网关 nginx_10

 

部分字段说明:

字段名称

字段描述

所属分组

可根据上游或业务域进行分组

API名称

可输入中英文名称

请求路径

API的URI,用于应用请求URL中的相对路径

绑定上游服务

可选值是上游服务列表,请求转发到上游,API所属上游服务

请求方式

支持常见HTTP请求方式GET、POST、PUT、DELETE等,支持多选

转发上游路径

上游服务提供对应的API相对路径,默认转发上游路径继承请求路径

请求超时时间

定义网关转发请求到上游至响应的单次消耗时间

重试次数

当转发请求到上游失败时,网关会自动触发重试转发请求,最大次数不超过重试次数

高级匹配

支持通过请求头,请求参数、Cookie 进行路由匹配,可添加多条,应用于灰度发布

转发上游请求头

可对转发上游请求头进行新建、编辑以及删除参数,主要应用于网关与上游间鉴权

新建的testnews的API如下图所示:

API网关 nginx api网关 开源_API网关 nginx_11

 

第三步:上线该API到集群:

API网关 nginx api网关 开源_端系统_12

 

3.4 调用API

在测试转发testnews这个API前,我们先测试直接调用后端这个API,测试结果如下图所示:

API网关 nginx api网关 开源_API_13

 

说明后端这个服务的API是正常可以调用的。

3.4.1 获取testnews完整调用地址

调用API的URL:网关节点的服务地址+API的请求路径:

第一步:获取服务地址:

API网关 nginx api网关 开源_开源_14

 

第二步:获取testnews的请求路径:

API网关 nginx api网关 开源_端系统_15

 

第三步:拼接地址,得到testnews这个API的完整请求路径:网关节点的服务地址+API的请求路径

3.4.2 用API研发管理工具Apikit来测试

API网关 nginx api网关 开源_端系统_16

 

测试结果与浏览器访问结果一致,表明网关转发功能正常

4、总结

Apinto网关开箱即用,整个过程仅用2个小时就能快速入门,至于其他功能后续再进行研究!

喜欢或感兴趣的小伙伴们赶紧去下载安装体验吧!

为了支持Apinto团队提供更好的开源体验,记得fork一下噢。

开源地址:https://github.com/eolinker/apinto