🚀快速入门教程

使用步骤

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 中,如上例中的 idapintoapi@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"
}