Apache APISIX 3.2.0 LTS 正式发布

2023-03-17
上海
本文字数：2954 字
阅读完需：约 10 分钟

APISIX 3.2.0 是 3.0 大版本以来的第一个 LTS 版本。此次发版，是 3.x 时代更替 2.x 时代的一大里程碑。从此之后，新的一系列 patch 版本将会在 3.2 的基础上发布。本次发布一如往常一样带来了许多新的插件和特性，为 APISIX 的使用者带来不一样的新玩法。

原文链接

新特性：四层上的服务发现

只有少数网关支持服务发现，APISIX 就是其中之一。在 3.2.0 版本中，APISIX 把原来七层上的服务发现的功能也做到了四层上。这样一来，将 APISIX 作为 TCP/UDP 代理时也能享受到服务发现带来的便利性。和在七层上的服务发现一样，要想用上服务发现，我们需要先在 config.yaml 中配置服务发现服务器的地址：

discovery:  nacos:    host:      - "http://192.168.33.1:8848"

复制代码

然后在具体的 upstream 上配置 discovery_type 和 service_name：

$ curl http://127.0.0.1:9180/apisix/admin/stream_routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -i -d '{    "remote_addr": "127.0.0.1",    "upstream": {        "scheme": "tcp",        "discovery_type": "nacos",        "service_name": "APISIX-NACOS",        "type": "roundrobin"    }}'

复制代码

这样访问 stream_routes 时，上游的节点会从 Nacos 的 APISIX-NACOS 服务中获取。

新插件：RESTful 请求转 GraphQL

在 3.2 版本中，APISIX 新增了一个能将 RESTful 请求转成 GraphQL 的插件。假如你有这样的 GraphQL 查询语句：

query($name: String!, $githubAccount: String!) {  persons(filter: { name: $name, githubAccount: $githubAccount }) {    id    name    blog    githubAccount    talks {      id      title    }  }}

复制代码

其中 $name 和 $githubAccount 是两个 GraphQL 变量。

我们可以用如下的配置来暴露出同样的 RESTful 接口：

curl --location --request PUT 'http://localhost:9180/apisix/admin/routes/1' \--header 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' \--header 'Content-Type: application/json' \--data-raw '{    "uri": "/graphql",    "upstream": {        "type": "roundrobin",        "nodes": {            "127.0.0.1:8080": 1        }    },    "plugins": {        "degraphql": {            "query": "query($name: String!, $githubAccount: String!) {\n  persons(filter: { name: $name, githubAccount: $githubAccount }) {\n    id\n    name\n    blog\n    githubAccount\n    talks {\n      id\n      title\n    }\n  }\n}",            "variables": [                "name",                "githubAccount"            ]        }    }}'

复制代码

这里 query 是我们要用到的查询语句，variables 是事先声明的变量列表。

接下来就能像 RESTful 接口一样访问它：

curl --location --request POST 'http://localhost:9080/graphql' \--header 'Content-Type: application/json' \--data-raw '{    "name": "Niek",    "githubAccount": "npalm"}'

复制代码

结果跟直接用对应的 GraphQL 语句访问上游是一样的：

{  "data": {    "persons": [      {        "id": "7",        "name": "Niek",        "blog": "https://040code.github.io",        "githubAccount": "npalm",        "talks": [          {            "id": "19",            "title": "GraphQL - The Next API Language"          },          {            "id": "20",            "title": "Immutable Infrastructure"          }        ]      }    ]  }}

复制代码

你同样能用 GET 请求来访问同样的接口，这时候参数就需要通过 query string 来传递：

curl 'http://localhost:9080/graphql?name=Niek&githubAccount=npalm'

复制代码

新特性：支持在每个日志插件上设置日志格式

在 3.2 版本，我们整理了 APISIX 现有的十多个 access 日志插件。现在每个插件都支持配置自定义日志格式：

在该插件的 plugin metadata 中定义全局的日志格式
在具体的路由规则上的该插件的配置中定义当前路由的日志格式

以 clickhouse-logger 为例，下面是定义全局日志格式的做法：

curl http://127.0.0.1:9180/apisix/admin/plugin_metadata/clickhouse-logger \-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{    "log_format": {        "host": "$host",        "@timestamp": "$time_iso8601",        "client_ip": "$remote_addr"    }}'

复制代码

下面则是当前路由的日志格式：

curl http://127.0.0.1:9180/apisix/admin/routes/1 \-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{      "plugins": {            "clickhouse-logger": {                "log_format": {                    "host": "$host",                    "@timestamp": "$time_iso8601",                    "client_ip": "$remote_addr"                },                "user": "default",                "password": "a",                "database": "default",                "logtable": "test",                "endpoint_addrs": ["http://127.0.0.1:8123"]            }       },      "upstream": {           "type": "roundrobin",           "nodes": {               "127.0.0.1:1980": 1           }      },      "uri": "/hello"}'

复制代码

新插件：请求体/响应体转换

你是否在为如何把返回 XML 的古早上游服务介绍给只接受 JSON 的现代客户端而苦恼？3.2.0 版本新增的 body-transformer 插件开源解决这个问题。

body-transformer 插件支持 JSON 和 XML 之间的互相转换。不过这并非是它唯一能做的事。它还支持通过模板配置输入输出的内容的具体格式。举个例子，

假设你有下面的 JSON 模板：{"foo":"{{name .. " world"}}","bar":{{age+10}}}，并把它配置到 body-transformer 插件的 request.template 字段中：

      ...      "body-transformer": {          "request": {              "template": "..."          }      }      ...

复制代码

那么当请求内容为 {"name":"hello","age":20}，发送给上游的是改写之后的 {"foo":"hello world","bar":30}。我们采用了 lua-resty-template 来渲染模板，所以你可以在模板中嵌入 Lua 表达式来实现改写逻辑。

对上游输出的改写也是类似的，只是需要配置的是插件的 response.template 字段。

新功能：优化和更多的小功能

除了上面提到的几个大的功能外，此次发布也包含许多值得述说的改动：

error-log-logger 插件支持发送错误日志到 Kafka
limit-count 插件支持返回 X-RateLimit-Reset 响应头

等等。

如果你对完整的内容感兴趣，请参考 3.2 发布的 CHANGELOG：https://github.com/apache/apisix/blob/release/3.2/docs/zh/latest/CHANGELOG.md#320

关于 API7.ai 与 APISIX

API7.ai（支流科技）是一家提供 API 处理和分析的开源基础软件公司，于 2019 年开源了新一代云原生 API 网关 -- APISIX 并捐赠给 Apache 软件基金会。此后，API7.ai 一直积极投入支持 Apache APISIX 的开发、维护和社区运营。与千万贡献者、使用者、支持者一起做出世界级的开源项目，是 API7.ai 努力的目标。

发布于: 刚刚阅读数: 3

API7.ai 技术团队

关注

https://apiseven.com 2021-06-02 加入

API7.ai 是一家提供 API 处理和分析的开源基础软件公司，于 2019 年开源了新一代云原生 API 网关 -- APISIX 并捐赠给 Apache 软件基金会。此后，API7.ai 一直积极投入支持 Apache APISIX 的开发、维护和社区运营。

发布

暂无评论

创作场景

Apache APISIX 3.2.0 LTS 正式发布

新特性：四层上的服务发现

新插件：RESTful 请求转 GraphQL

新特性：支持在每个日志插件上设置日志格式

新插件：请求体/响应体转换

新功能：优化和更多的小功能

关于 API7.ai 与 APISIX

API7.ai 技术团队

评论