通过 APISIX 代理 gRPC 连接,并使用 APISIX 的大部分特性管理你的 gRPC 服务。
scheme
: Route 对应的 Upstream 的 scheme
必须设置为 grpc
或者 grpcs
uri
: 格式为 /service/method 如:/helloworld.Greeter/SayHello在指定 Route 中,代理 gRPC 服务接口:
scheme
必须设置为 grpc
或者 grpcs
。curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d ' { "methods": ["POST", "GET"], "uri": "/helloworld.Greeter/SayHello", "upstream": { "scheme": "grpc", "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" }
grpcurl 是一个 CLI 工具,类似于 curl,充当 gRPC 客户端并让您与 gRPC 服务器进行交互。安装方式请查看官方文档
这表示已成功代理。
默认情况下,APISIX 只在 9443
端口支持 TLS 加密的 HTTP/2。你也可以支持纯本文的 HTTP/2,只需要修改 conf/config.yaml
文件中的 node_listen
配置即可。
apisix: node_listen: - port: 9080 enable_http2: false - port: 9081 enable_http2: true
访问上面配置的 Route:
grpcurl -plaintext -import-path /pathtoprotos -proto helloworld.proto \ -d '{"name":"apisix"}' 127.0.0.1:9081 helloworld.Greeter.SayHello { "message": "Hello apisix" }
这表示已成功代理。
如果你的 gRPC 服务使用了自己的 TLS 加密,即所谓的 gPRCS
(gRPC + TLS),那么需要修改 scheme 为 grpcs
。继续上面的例子,50052 端口上跑的是 gPRCS 的服务,这时候应该这么配置:
curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d ' { "methods": ["POST", "GET"], "uri": "/helloworld.Greeter/SayHello", "upstream": { "scheme": "grpcs", "type": "roundrobin", "nodes": { "127.0.0.1:50052": 1 } } }'