buoyantio/bb

bb

bb（Building Blocks）是一个工具，可模拟基于微服务的云原生面向服务架构的许多典型场景。

核心功能和特性

• 多服务策略支持：提供多种服务策略，包括terminus（返回预定义响应）、point-to-point-channel（转发至单个下游服务）、broadcast-channel（转发至所有下游服务）和http-egress（发起HTTP(S)调用）等。
• 标准化接口：通过protobuf模式（仓库中的api.proto）定义消息交互，使容器可灵活组合成不同架构。
• 多协议支持：同时支持gRPC和HTTP 1.1协议，可作为服务端接收请求或作为客户端转发请求。
• 灵活部署：支持本地环境（非容器）、Docker容器及Kubernetes集群部署，满足不同测试需求。
• 可配置行为：支持设置下游超时、失败率、处理延迟、请求数限制等参数，模拟真实服务行为。

使用场景和适用范围

• 本地开发测试：快速搭建微服务交互场景，验证服务间通信逻辑和数据流转。
• Kubernetes集群环境：创建复杂微服务拓扑，测试服务网格、流量管理、故障恢复等云原生特性。

使用方法和配置说明

镜像信息

bb发布单个容器镜像：buoyantio/bb:v0.0.5。容器实例通过protobuf定义的接口进行消息交互，可灵活组合成各类服务架构。

本地运行（非Docker/Kubernetes环境）

需先构建适用于本地环境的二进制文件：

1. 从仓库根目录执行构建命令：

   bash
   $ mkdir -p target && go build -o target/bb .
   

   二进制文件将生成在target目录下（注意：非Linux环境构建的二进制可能无法在Docker或Kubernetes中使用）。

2. 两服务交互示例：

   • 终端1：启动terminus服务（gRPC服务器，返回预定义响应）

     bash
     $ target/bb terminus --grpc-server-port 9090 --response-text BANANA
     

   • 终端2：启动point-to-point-channel服务（HTTP 1.1服务器，转发请求至下游gRPC服务）

     bash
     $ target/bb point-to-point-channel --grpc-downstream-server localhost:9090 --h1-server-port 8080
     

   • 终端3：发送请求测试

     bash
     $ curl localhost:8080
     {"requestUid":"in:http-sid:point-to-point-channel-grpc:-1-h1:8080-387107000","payload":"BANANA"}
     

在Kubernetes上运行

bb的主要应用场景是在Kubernetes集群中创建复杂环境，以下以Minikube为例说明部署步骤：

1. 确保Minikube运行：

   bash
   $ minikube status
     minikube: Running
     cluster: Running
     kubectl: Correctly Configured: pointing to minikube-vm at 192.168.99.100
   

2. 配置Docker环境变量以使用Minikube镜像仓库：

   bash
   $ eval "$(minikube docker-env)"
   

3. 构建bb Docker镜像：

   bash
   $ bin/docker-build-bb.sh
   Sending build context to Docker daemon  136.7MB
   Step 1/6 : FROM buoyantio/base:2017-10-30.01
    ---> 14aa74f25501
   Step 2/6 : RUN apt-get update
   [...]
   Removing intermediate container f4f571b01dd8
   Successfully built e6d76c5df612
   Successfully tagged buoyantio/bb:v0.0.5
   

4. 验证镜像：

   bash
   $ docker run buoyantio/bb:v0.0.5
   

   应输出工具使用信息，确认镜像正常。

5. 部署示例应用：

   • 使用examples目录中的YAML配置：

     bash
     $ kubectl apply -f examples/bb-readme/application.yaml
     

   • 测试服务：

     bash
     $ curl `minikube -n bb-readme service bb-readme-gateway-svc --url`
     {"requestUid":"in:http-sid:point-to-point-channel-grpc:-1-h1:8080-66349706","payload":"BANANA"}
     

配置参数说明

可用命令

• broadcast-channel：将请求转发至所有下游服务
• help：查看命令帮助信息
• http-egress：接收请求并向指定URL发起HTTP(S)调用，返回响应体
• point-to-point-channel：将请求转发至唯一的下游服务
• terminus：接收请求并返回预定义响应

全局标志

使用bb [command] --help可查看各命令的详细说明。