buoyantio/strest-grpc

strest-grpc镜像说明

镜像概述

strest-grpc是Strest的gRPC客户端和服务器实现，专为压力测试gRPC中介（如服务网格）设计。它支持本地运行和Kubernetes集群部署，能够生成详细的性能报告，帮助开发者评估gRPC服务的吞吐量、延迟和稳定性。

核心功能

• 负载测试：对gRPC服务或中介发起高并发请求，生成包含请求数、延迟分布、抖动等指标的性能报告
• 最大RPS计算：基于Universal Scalability Law计算服务的最大每秒请求数（RPS）
• 流式支持：提供gRPC流式请求/响应的测试能力
• 多环境适配：支持本地运行和Kubernetes集群部署
• 安全特性：支持TLS证书验证和Unix域套接字
• 参考实现：提供gRPC参考客户端和服务器，用于对比测试

使用场景

• 本地开发阶段：测试gRPC服务的性能瓶颈
• 服务网格评估：验证Istio等gRPC中介的吞吐量和稳定性
• 生产环境预演：模拟高并发场景，评估服务的最大承载能力
• 性能优化：通过延迟分布数据定位gRPC服务的性能问题

配置说明

本地运行步骤

1. 启动服务器：

bash
docker run --rm -p 11111:11111 buoyantio/strest-grpc server

2. 运行客户端（生成性能报告）：

bash
docker run --rm buoyantio/strest-grpc client --address host.docker.internal:11111 --latencyUnit us

关键命令参数

客户端（client）

• --address：目标服务地址（默认localhost:***）
• --connections：并发连接数（默认1）
• --totalTargetRps：目标每秒请求数
• --latencyUnit：延迟单位（ms/us/ns，默认ms）
• --streaming：启用流式请求

服务器（server）

• --address：监听地址（默认:***）
• --tlsCertFile：TLS证书路径
• --tlsPrivKeyFile：TLS私钥路径

最大RPS计算（max-rps）

bash
docker run --rm buoyantio/strest-grpc max-rps --address host.docker.internal:11111

Kubernetes部署

1. 部署服务器：

bash
kubectl apply -f https://raw.githubusercontent.com/BuoyantIO/strest-grpc/main/config/server.yml

2. 部署客户端：

bash
kubectl apply -f https://raw.githubusercontent.com/BuoyantIO/strest-grpc/main/config/client.yml

3. 查看客户端日志：

bash
kubectl logs -c strest-client deploy/strest-client

构建镜像

若需自定义构建镜像：

bash
git clone https://github.com/BuoyantIO/strest-grpc.git
cd strest-grpc
docker build -t your-repo/strest-grpc:latest .