forked from iresty / Apache APISIX

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

克隆/下载

grpc-proxy.md 2.09 KB

[English](../grpc-proxy.md)

# grpc-proxy

通过 APISIX 代理 gRPC 连接，并使用 APISIX 的大部分特性管理你的 gRPC 服务。

## 参数

* `service_protocol`:  这个 Route 的属性 `service_protocol` 必须设置为 `grpc`
* `uri`:   格式为 /service/method 如：/helloworld.Greeter/SayHello

## 示例

### 创建代理 gRPC 的 Route

在指定 Route 中，代理 gRPC 服务接口:

* 注意： 这个 Route 的属性 `service_protocol` 必须设置为 `grpc`；
* 注意： APISIX 使用 TLS 加密的 HTTP/2 暴露 gRPC 服务, 所以需要先 [配置 SSL 证书](https.md)；
* 下面例子所代理的 gRPC 服务可供参考：[grpc_server_example](https://github.com/iresty/grpc_server_example)。

```shell
curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "methods": ["POST", "GET"],
    "uri": "/helloworld.Greeter/SayHello",
    "service_protocol": "grpc",
    "upstream": {
        "type": "roundrobin",
        "nodes": {
            "127.0.0.1:50051": 1
        }
    }
}'
```

### 测试

访问上面配置的 Route：

```shell
grpcurl -insecure -import-path /pathtoprotos  -proto helloworld.proto  \
    -d '{"name":"apisix"}' 127.0.0.1:9443 helloworld.Greeter.SayHello
{
  "message": "Hello apisix"
}
```

这表示已成功代理。

一键复制编辑原始数据按行查看历史

提交于 2020-06-19 06:03 . doc: Refactoring docs to support docsify (#1724)

grpc-proxy

通过 APISIX 代理 gRPC 连接，并使用 APISIX 的大部分特性管理你的 gRPC 服务。

参数

service_protocol: 这个 Route 的属性 service_protocol 必须设置为 grpc
uri: 格式为 /service/method 如：/helloworld.Greeter/SayHello

示例

创建代理 gRPC 的 Route

在指定 Route 中，代理 gRPC 服务接口:

注意：这个 Route 的属性 service_protocol 必须设置为 grpc；
注意： APISIX 使用 TLS 加密的 HTTP/2 暴露 gRPC 服务, 所以需要先配置 SSL 证书；
下面例子所代理的 gRPC 服务可供参考：grpc_server_example。

curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "methods": ["POST", "GET"],
    "uri": "/helloworld.Greeter/SayHello",
    "service_protocol": "grpc",
    "upstream": {
        "type": "roundrobin",
        "nodes": {
            "127.0.0.1:50051": 1
        }
    }
}'

测试

访问上面配置的 Route：

grpcurl -insecure -import-path /pathtoprotos  -proto helloworld.proto  \
    -d '{"name":"apisix"}' 127.0.0.1:9443 helloworld.Greeter.SayHello
{
  "message": "Hello apisix"
}

这表示已成功代理。

Lua

1

https://gitee.com/liujunao153/apisix.git

git@gitee.com:liujunao153/apisix.git

liujunao153

apisix

Apache APISIX

master