mozilla/merinopy-locust

merino-py负载测试Locust镜像

镜像概述

本镜像基于Locust负载测试框架构建，专门用于对merino-py服务进行性能负载测试。通过模拟大量并发用户行为，可有效评估merino-py服务在不同负载条件下的响应性能、稳定性及承载能力，为系统优化和容量规划提供数据支持。

核心功能与特性

• 用户行为模拟：支持自定义测试脚本，模拟真实用户对merino-py服务的请求行为（如查询、推荐交互等）
• 灵活负载控制：可配置并发用户数、用户生成速率，支持逐步加压以定位系统性能临界点
• 实时性能监控：内置Web控制台（默认端口8089），实时展示请求成功率、响应时间、每秒请求数（RPS）等关键指标
• 测试报告生成：支持导出CSV/JSON格式性能报告，包含详细请求统计与趋势数据
• merino-py适配：预设基础测试场景模板，简化针对merino-py服务的测试配置流程

使用场景

• 开发阶段性能验证：验证merino-py新功能在不同用户量下的响应性能
• 上线前压力测试：模拟生产环境预期流量，验证系统在峰值负载下的稳定性
• 系统优化评估：对比优化前后的性能数据，量化架构调整或代码优化效果
• 容量规划支持：通过极限施压确定merino-py服务的最大承载能力，指导服务器资源配置

使用方法

基础运行方式

通过以下命令启动镜像，使用默认配置对merino-py服务进行测试：

bash
docker run -p 8089:8089 locust-merino-py

启动后访问 http://localhost:8089 打开Locust Web界面，配置并发用户数和生成速率，点击"Start swarming"开始测试。

自定义测试脚本

挂载本地测试脚本以模拟特定用户行为（如调用merino-py特定API）：

bash
docker run -p 8089:8089 \
  -v /local/path/to/test_script.py:/locust/locustfile.py \
  locust-merino-py

注：测试脚本需遵循Locust规范，定义HttpUser类及任务方法

无界面批量测试

在CI/CD流程或自动化测试中，可使用命令行模式运行：

bash
docker run locust-merino-py \
  --headless \
  -u 200 \                  # 并发用户数
  -r 20 \                   # 每秒生成用户数
  -H http://merino-service:8000 \  # 目标merino-py服务地址
  -t 30m                    # 测试持续时间

配置参数

环境变量

端口映射

注意事项

1. 测试前确保merino-py服务已启动且网络可通（容器需能访问目标服务地址）
2. 自定义脚本需使用Python编写，可调用locust库API定义用户行为
3. 高并发测试建议在独立环境执行，避免影响生产服务
4. 测试结果需结合merino-py服务日志及监控数据综合分析性能瓶颈