# 前提条件

本文使用的gRPC服务样例:https://github.com/wehotel/fizz-examples/tree/master/fizz-example-grpc (opens new window)

本文后面使用的接口为findById, 接口会回显入参的ID和返回name字段,JSON如下:

{
	"name": "call findById",
	"id": "入参ID"
}

# 服务和接口维护

把gRPC服务实例和接口集中维护,方便在服务编排里多次调用。因网关是通过泛化调用gRPC接口,所以gRPC服务本身需启用反射功能,请参考样例:

server = ServerBuilder.forPort(port)
     .addService(new UserService())
     .addService(new ShoppingCartService())
     // 开启gRPC反射
     .addService(ProtoReflectionService.newInstance())
     .build();

进入FizzGate管理后台, 打开RPC管理 -> 服务管理, 点击新增填写服务名和实例等信息,多个实例用逗号分隔,网关会轮询调用。

打开RPC管理 -> 接口管理, 点击新增把你需要的接口录入到系统,没有用到的接口可以不录入

# 服务编排调用gRPC接口

打开服务编排 -> 接口列表,新增一个接口, 选择所属服务(如:func-test), 如果还没有服务可点击右边的新增服务按钮添加, 接口路径为/grpc/user/findById, 如图:

选择前面步骤录入的grpc接口, 并设置grpc接口入参,采用引用值引用服务编排接口的Query参数, 关于参数的配置可参考文档:(服务编排-数据转换 (opens new window))

配置服务编排接口的输出:

保存接口

# 配置路由

打开网关管理 -> 路由管理, 点击新增配置以下路由

# 测试

回到服务编排的接口,点击测试. 填写Query参数id=666, 服务编排接口是透传了gRPC服务的findById的数据,得到以下结果:

# 发布

服务编排接口需要发布才可以对外提供服务,打开编排审核 -> 我的申请,新增一个发布申请,为了方便操作选择超级管理员为审核人

打开待审核列表,审核上一步的单子:

打开我的申请,点击申请单的查看操作:

发布接口:

# 访问正式接口

访问http://[网关IP]:8600/proxy/func-test/grpc/user/findById?id=666

结果: