🚀快速入门教程
使用步骤
1、创建服务
2、绑定路由
流程示意图如下:
详细步骤说明
Apinto支持以下方式进行网关配置:
- openAPI:可在网关使用过程中动态配置网关信息,包括路由、服务、负载均衡、鉴权、服务发现等
程序配置说明
程序启动前需要配置与程序相同目录下的文件config.yml
,用于指定节点的路由监听端口,ssl证书等信息。
listen: # 节点的路由监听端口
- 8099
ssl:
listen:
- port: 443 #https端口
certificate: # 不配表示使用所有 cert_dir中的证书,默认pem文件后缀为pem,key后缀为key
- cert: cert.pem
key: cert.key
admin: # openAPI request info
scheme: http # listen scheme
listen: 9400 # listen port
ip: 0.0.0.0 # listen ip
certificate:
dir: ./cert # 证书文件目录,不填则默认从cert目录下载
启动程序
./apinto start
使用openAPI配置网关
在程序启动后,我们可以通过openAPI动态配置网关信息
创建服务
以访问apinto官方示例接口为例, 将返回请求的相关信息。
curl -X POST http://127.0.0.1:9400/api/service \
-H "Content-type: application/json" \
-d '{
"name": "apintoapi",
"driver": "http",
"description": "访问官方示例接口",
"timeout": 3000,
"retry": 3,
"scheme": "http",
"nodes": ["demo-apinto.eolink.com:8280"],
"balance": "round-robin"
}'
服务配置参数说明点此进行跳转
创建路由,并且服务id绑定路由
将第1步返回的 id 值填入到路由配置的 target 中,如上例中的 id 为 apintoapi@service
curl -X POST http://127.0.0.1:9400/api/router \
-H "Content-type: application/json" \
-d '{
"name": "apintoapi",
"driver": "http",
"description": "路由示例",
"listen": 8099,
"rules": [{
"location": "/demo"
}],
"target": "apintoapi@service"
}'
注意:路由配置的listen
必须在config.yml中的路由监听端口列表中存在。
路由配置参数说明点此进行跳转
至此,带有路由的服务转发配置完成
访问服务
curl 'http://127.0.0.1:8099/demo'
返回结果
{
"body":"",
"header":{
"Accept":[
"*/*"
],
"User-Agent":[
"curl/7.75.0"
],
"X-Forwarded-For":[
"127.0.0.1,127.0.0.1"
]
},
"host":"127.0.0.1:8099",
"method":"GET",
"path":"/demo",
"query":{
},
"url":"/demo"
}