dockertesteng/reference-app

dockertesteng/reference-app 镜像说明

镜像概述

dockertesteng/reference-app是轻量级分布式网络负载测试工具，通过控制器- worker模式模拟多节点间的HTTP POST通信，帮助用户评估网络吞吐量、系统稳定性及分布式系统的通信性能。

核心功能

• 动态配置每秒数据包数（pps）和消息大小（kbytes）
• 灵活扩展worker节点数量，模拟大规模并发流量
• 实时日志监控流量发送状态
• HTTP API快速调整负载参数

使用场景

• 测试网络设备（交换机、路由器）的处理能力
• 验证分布式系统在高并发场景下的稳定性
• 评估服务器对HTTP POST请求的承载能力
• 模拟真实业务流量进行性能基准测试

配置说明

部署示例（Docker Stack）

yaml
version: "3.1"
services:
    controller:
        image: dockertesteng/reference-app:latest
        command: --mode=controller
        networks:
            - ref-app-net
        ports:
            - "8088:8080"
    worker:
        depends_on:
            - controller
        image: dockertesteng/reference-app:latest
        command: --mode=worker
        networks:
            - ref-app-net
        deploy:
            replicas: 2
networks:
    ref-app-net:
        driver: overlay

执行部署：

bash
docker stack deploy --compose-file docker-compose.yml ref-app

扩展Worker节点

增加负载规模：

bash
docker service scale ref-app_worker=5

查看流量日志

监控worker节点状态：

bash
docker service logs ref-app_worker

调整负载参数

通过API修改流量配置：

bash
curl \
  -i \
  -H content-type:application/json \
  -X POST \
  -d '{ "pps": 1, "kbytes": 100 }' \
  http://localhost:8088/spec

参数说明：

• pps：每个worker每秒向其他worker发送消息的次数
• kbytes：单条消息的大小（千字节） ===FULL_DESC===