在Solo.io Gloo中实现gRPC服务路由配置指南

前言

在现代微服务架构中，gRPC因其高效的二进制协议和强大的流式处理能力而广受欢迎。本文将详细介绍如何在Solo.io Gloo网关中配置gRPC服务路由，帮助开发者实现高性能的gRPC服务暴露与管理。

环境准备

在开始之前，请确保满足以下条件：

1. 已部署Kubernetes集群
2. 已安装Gloo Gateway 1.14或更高版本
3. 已安装grpcurl工具作为gRPC客户端
4. 已安装openssl工具用于安全凭证创建

部署gRPC演示应用

1. 部署Store服务

首先部署一个演示用的gRPC Store应用：

kubectl create deployment grpcstore-demo --image=docker.io/soloio/grpcstore-demo
kubectl expose deployment grpcstore-demo --port 80 --target-port=8080

2. 验证上游服务发现

Gloo Gateway会自动发现gRPC服务并创建对应的Upstream资源：

kubectl get upstream -n gloo-system default-grpcstore-demo-80

3. 启用功能发现

为获取gRPC服务的proto描述符，需要启用功能发现：

kubectl label upstream -n gloo-system default-grpcstore-demo-80 discovery.solo.io/function_discovery=enabled

4. 配置HTTP/2协议

gRPC基于HTTP/2协议，需要确保Envoy代理使用HTTP/2：

spec:
  ports:
  - name: grpc  # 通过端口名标识为gRPC服务
    port: 80
    protocol: TCP
    targetPort: 8080

配置虚拟服务路由

创建VirtualService资源将请求路由到gRPC上游：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: grpc
  namespace: gloo-system
spec:
  virtualHost:
    routes:
      - matchers:
          - prefix: /
        routeAction:
          single:
            upstream:
              name: default-grpcstore-demo-80
              namespace: gloo-system

使用gRPC客户端测试

1. 列出可用服务

grpcurl -plaintext $(glooctl proxy address --port http) list

2. 调用服务方法

创建商品：

grpcurl -plaintext -d '{"item":{"name":"item1"}}' \
  $(glooctl proxy address --port http) \
  solo.examples.v1.StoreService/CreateItem

列出商品：

grpcurl -plaintext $(glooctl proxy address --port http) \
  solo.examples.v1.StoreService/ListItems

安全加固配置

1. 限制访问域名

更新VirtualService只允许特定域名访问：

spec:
  virtualHost:
    domains:
    - store.example.com

2. 配置TLS加密

创建安全凭证：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout tls.key -out tls.crt -subj "/CN=store.example.com"

创建Kubernetes Secret：

kubectl create secret tls grpc-tls \
  --key tls.key --cert tls.crt --namespace gloo-system

配置VirtualService使用TLS：

glooctl edit virtualservice --name grpc --namespace gloo-system \
  --ssl-secret-name grpc-tls --ssl-secret-namespace gloo-system

3. 安全连接测试

grpcurl -insecure -authority store.example.com \
  $(glooctl proxy address --port https) \
  solo.examples.v1.StoreService/ListItems

技术要点解析

1. HTTP/2支持：gRPC基于HTTP/2协议，Gloo通过识别特定端口名或注解自动启用HTTP/2支持。

2. Proto描述符：功能发现(FDS)自动获取gRPC服务的proto描述符，为后续的gRPC转码等功能提供支持。

3. TLS终止：Gloo在代理层终止TLS连接，减轻后端服务负担，同时保证传输安全。

4. 域名路由：通过VirtualService的domain配置实现基于域名的精细路由控制。

最佳实践建议

1. 生产环境应使用可信CA签发的证书而非自签名证书
2. 考虑为gRPC服务配置连接池和超时设置
3. 对于性能敏感场景，可调整HTTP/2的连接窗口大小
4. 监控gRPC特定的指标如流错误率和RPC延迟

总结

本文详细介绍了在Solo.io Gloo中配置gRPC服务路由的全过程，从基础部署到安全加固。通过Gloo Gateway，开发者可以轻松将gRPC服务暴露给外部客户端，同时享受丰富的流量管理功能和安全保障。