APISIX是一款基于Openresty的动态、实时、高性能API网关，它提供了负载均衡、服务熔断等丰富的功能。

安装服务

在https://github.com/apache/apisix-docker中提供了很多很便利的docker配置，可以很方便的启动APISIX的相关服务。

~ git clone git@github.com:apache/apisix-docker.git~ cd apisix-docker/example/~ docker-compose upStarting example_etcd_1             ... doneStarting example_grafana_1          ... doneStarting example_apisix-dashboard_1 ... doneStarting example_web2_1             ... doneStarting example_web1_1             ... doneStarting example_prometheus_1       ... doneStarting example_apisix_1           ... doneAttaching to example_grafana_1, example_etcd_1, example_apisix-dashboard_1, example_web1_1, example_web2_1, example_prometheus_1, example_apisix_1

如上启动了7个容器，分别是：

• 配置中心：etcd
• 展示prometheus的指标：grafana
• apisix的管理控制台：apisix-dashboard
• 测试服务：web2
• 测试服务：web1
• 采集apisix的指标：prometheus
• apisix本体

接下来我们可以测试一下apisix

~ curl http://127.0.0.1:9180/apisix/admin/routes -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' {"total":0,"list":[]}

如上命令用于查看apisix的所有路由信息，使用默认的API-KEY。

使用Admin API管理路由

路由用于通过规则匹配客户端的请求，并根据请求加载相应的插件，最后将请求转发到指定的上游服务。由此可知路由由三部分组成

1. 客户端请求的匹配规则：包含method、host、uri等
2. 插件，例如流控、安全认证等等，插件是可选的
3. 上游服务

APISIX的Admin接口都采用了Restful风格，路由资源的地址为/apisix/admin/routes/{id}，它的操作接口如下

接下来我们创建一个上游为web1的路由

~ curl -X PUT http://127.0.0.1:9180/apisix/admin/routes/1 \    -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -i -d '{    "methods": ["GET"],    "uri": "/web1",    "upstream": {        "type": "roundrobin",        "nodes": {            "web1:80": 1        }    }}'HTTP/1.1 201 Created...{"key":"/apisix/routes/1","value":{"status":1,"methods":["GET"],"id":"1","priority":0,"uri":"/web1","update_time":1706606490,"upstream":{"scheme":"http","hash_on":"vars","type":"roundrobin","nodes":{"web1:80":1},"pass_host":"pass"},"create_time":1706606490}}

返回201表示创建成功，之后我们可以访问这个新建的路由接口

~ curl http://127.0.0.1:9080/web1hello web1

上游（Upstream）

除了直接使用服务之外，为了方便，我们还可以把服务的资源直接定义为一个上游（Upstream）

~ curl -X PUT http://127.0.0.1:9180/apisix/admin/upstreams/1 \    -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -i -d '{    "type": "roundrobin",    "nodes": {        "web1:80": 1    }}'HTTP/1.1 201 Created...{"key":"/apisix/upstreams/1","value":{"scheme":"http","create_time":1706606769,"hash_on":"vars","id":"1","type":"roundrobin","update_time":1706606769,"pass_host":"pass","nodes":{"web1:80":1}}}

如上我们把web1这个服务定义为上游（Upstream）1，之后我们可以直接使用这个上游构建路由

~ curl -X PUT http://127.0.0.1:9180/apisix/admin/routes/1 \    -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -i -d '{    "methods": ["GET"],    "uri": "/web1",    "upstream_id": "1"}'HTTP/1.1 200 OK...{"key":"/apisix/routes/1","value":{"upstream_id":"1","methods":["GET"],"status":1,"priority":0,"uri":"/web1","update_time":1706606904,"id":"1","create_time":1706606490}}

之后访问地址还是一样的效果

~ curl http://127.0.0.1:9080/web1                          hello web1

查看我们刚刚创建的路由和上游

~ curl http://127.0.0.1:9180/apisix/admin/upstreams -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1'{"total":1,"list":[{"key":"/apisix/upstreams/1","value":{"scheme":"http","create_time":1706607099,"hash_on":"vars","nodes":{"web1:80":1},"type":"roundrobin","id":"1","pass_host":"pass","update_time":1706607099},"createdIndex":35,"modifiedIndex":35}]}~ curl http://127.0.0.1:9180/apisix/admin/routes -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1'  {"total":1,"list":[{"key":"/apisix/routes/1","value":{"create_time":1706607103,"methods":["GET"],"id":"1","priority":0,"uri":"/web1","upstream_id":"1","update_time":1706607103,"status":1},"createdIndex":36,"modifiedIndex":36}]}

我们还可以删除我们刚刚创建的路由和上游

~ curl -X DELETE http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' {"key":"/apisix/routes/1","deleted":"1"}~ curl -X DELETE http://127.0.0.1:9180/apisix/admin/upstreams/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' {"key":"/apisix/upstreams/1","deleted":"1"}

插件

APISIX支持很多插件，以常见的流控插件为例

~ curl -X PUT http://127.0.0.1:9180/apisix/admin/routes/1 \     -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -i -d '{    "methods": ["GET"],    "uri": "/web1",    "plugins": {        "limit-count": {            "count": 2,            "time_window": 10,            "rejected_code": 503,            "key": "remote_addr"        },        "prometheus": {}    },    "upstream": {        "type": "roundrobin",        "nodes": {            "web1:80": 1        }    }}'HTTP/1.1 200 OK...

如上创建了一个路由，它使用了插件limit-count，参数表示每个远程地址每10秒钟最多请求两次，否则就会得到503错误。我们测试可以看到请求两次之后就开始报503错误，等待一会儿之后服务又恢复了

~ curl http://127.0.0.1:9080/web1                                                                hello web1%~ curl http://127.0.0.1:9080/web1hello web1%~ curl http://127.0.0.1:9080/web1<html><head><title>503 Service Temporarily Unavailable</title></head><body><center><h1>503 Service Temporarily Unavailable</h1></center><hr><center>openresty</center><p><em>Powered by <a href="https://apisix.apache.org/">APISIX</a>.</em></p></body></html>~ curl http://127.0.0.1:9080/web1<html><head><title>503 Service Temporarily Unavailable</title></head><body><center><h1>503 Service Temporarily Unavailable</h1></center><hr><center>openresty</center><p><em>Powered by <a href="https://apisix.apache.org/">APISIX</a>.</em></p></body></html>~ curl http://127.0.0.1:9080/web1hello web1%

与上游类似，我们也可以定义一个插件配置，之后在路由中直接使用

~ curl http://127.0.0.1:9180/apisix/admin/plugin_configs/1 \-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -i -d '{    "desc": "enable limit-count plugin",    "plugins": {        "limit-count": {            "count": 2,            "time_window": 10,            "rejected_code": 503        }    }}'HTTP/1.1 201 Created...{"key":"/apisix/plugin_configs/1","value":{"create_time":1706607965,"desc":"enable limit-count plugin","plugins":{"limit-count":{"count":2,"time_window":10,"key_type":"var","rejected_code":503,"policy":"local","allow_degradation":false,"show_limit_quota_header":true,"key":"remote_addr"}},"id":"1","update_time":1706607965}}

如上定义了一个id为1的插件，之后我们使用它构建一个路由

~ curl -X PUT http://127.0.0.1:9180/apisix/admin/routes/1 \    -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -i -d '{    "methods": ["GET"],    "uri": "/web1",    "upstream_id": "1",    "plugin_config_id": "1"}'HTTP/1.1 200 OK...{"key":"/apisix/routes/1","value":{"create_time":1706607103,"plugin_config_id":"1","priority":0,"update_time":1706608060,"methods":["GET"],"uri":"/web1","upstream_id":"1","status":1,"id":"1"}}

之后访问地址http://127.0.0.1:9080/web1的效果和前面是一样的。

Dashboard

apisix还可以使用Dashboard来管理路由，浏览器访问http://127.0.0.1:9000即可

默认的用户名和密码都是admin。登录之后我们就可以进行管理了，例如要新建一个路由

我们依次设置路由的名称、path、method以及上游信息

创建完成之后就可以在路由列表看到我们刚刚创建的路由了

之后访问我们刚刚创建的路由，和使用AdminAPI创建的效果是一样的

~ curl http://127.0.0.1:9080/web2hello web2

参考

APISIX 使用小记
https://apisix.apache.org/docs/apisix/admin-api/