dubbo-proxy
#
摘要#
简介dubbo-proxy
插件允许将 HTTP
请求代理到 dubbo。
#
要求如果你正在使用 OpenResty
, 你需要编译它来支持 dubbo
, 参考 如何编译。
在 APISIX
中为了实现使从 http
代理到 dubbo
,我们在Tengine
的 mod_dubbo
基础上对 dubbo
模块做了改进。 所有的修改已经提交给 Tengine
,但是还未合并到最新的 release
版本中(Tengine-2.3.2) 。所以目前 Tengine
自身是不支持此特性的。
#
运行时属性名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
---|---|---|---|---|---|
service_name | string | 必选 | dubbo 服务名字 | ||
service_version | string | 必选 | dubbo 服务版本 | ||
method | string | 可选 | uri路径 | dubbo 服务方法 |
#
静态属性名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
---|---|---|---|---|---|
upstream_multiplex_count | number | 必选 | 32 | >= 1 | 上游连接中最大的多路复用请求数 |
#
如何启用首先,在 config.yaml
中启用 dubbo-proxy
插件:
# Add this in config.yamlplugins: - ... # plugin you need - dubbo-proxy
然后重载 APISIX
。
这里有个例子,在指定的路由中启用 dubbo-proxy
插件:
curl http://127.0.0.1:9080/apisix/admin/upstream/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{ "nodes": { "127.0.0.1:20880": 1 }, "type": "roundrobin"}'
curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{ "uris": [ "/hello" ], "plugins": { "dubbo-proxy": { "service_name": "org.apache.dubbo.sample.tengine.DemoService", "service_version": "0.0.0", "method": "tengineDubbo" } }, "upstream_id": 1}'
#
测试插件你可以在 Tengine
提供的 快速开始 例子中使用上述配置进行测试。
将会有同样的结果。
从上游 dubbo
服务返回的数据一定是Map<String, String>
类型。
如果返回的数据如下
{ "status": "200", "header1": "value1", "header2": "valu2", "body": "blahblah"}
则对应的 HTTP
响应如下
HTTP/1.1 200 OK # "status" will be the status code...header1: value1header2: value2...
blahblah # "body" will be the body
#
禁用插件当你想在某个路由或服务中禁用 dubbo-proxy
插件,非常简单,你可以直接删除插件配置中的 json
配置,不需要重启服务就能立即生效:
$ curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '{ "methods": ["GET"], "uris": [ "/hello" ], "plugins": { }, "upstream_id": 1 }}'
现在 dubbo-proxy
插件就已经被禁用了。 此方法同样适用于其他插件。
如果你想彻底禁用 dubbo-proxy
插件,
你需要在 config.yaml
中注释掉以下内容:
plugins: - ... # plugin you need #- dubbo-proxy
然后重新加载 APISIX
。