neotys/neoload-loadgenerator

NeoLoad Load Generator 镜像文档

1. 镜像概述和主要用途

NeoLoad 是由Tricentis开发的负载测试解决方案，可模拟真实用户活动并监控基础设施行为，帮助定位Web和移动应用中的性能瓶颈。

NeoLoad Load Generator（负载生成器）是NeoLoad的核心组件之一，用于配合NeoLoad Controller或NeoLoad Web生成负载压力。它可独立部署，通过参数配置（如NeoLoad Web API URL、令牌等）接入测试环境，支持分布式负载生成。

2. 核心功能与特性

• 高性能负载生成：模拟大量用户活动，对被测服务器产生压力。
• 安全连接控制：支持通过可信控制器证书指纹限制访问（2023.1及以上版本），提升部署安全性。
• NeoLoad Web集成：可接入NeoLoad Web平台（6.6及以上版本），实现云端负载管理与监控。
• 灵活资源配置：支持自定义JVM内存参数（如最大堆内存），适配不同负载需求。
• 跨版本兼容：适配NeoLoad 6.5及以上版本，文件路径和配置方式随版本优化。

3. 使用场景与适用范围

• Web与移动应用性能测试：为各类Web服务、移动应用提供负载压力，验证系统在高并发下的稳定性。
• 分布式负载测试：通过多实例部署，模拟全球分布用户的访问场景。
• CI/CD流程集成：作为容器化组件嵌入自动化测试 pipeline，在应用发布前进行性能验证。
• NeoLoad Web云端管理：接入NeoLoad Web平台，实现负载生成器的集中监控与调度。

4. 使用方法与配置说明

4.1 基本信息

• 文件路径：
  • NeoLoad 6.5及以上版本：/home/neoload/neoload
  • 6.5以下版本：/neoload<VERSION>/（如/neoload6.4/）

4.2 启动方式

4.2.1 不安全模式（允许任意控制器连接）

适用于测试环境，负载生成器不限制控制器来源：

bash
docker run -p 7100:7100 -e AGENT_ACCEPT_ONLY=ALL neotys/neoload-loadgenerator

4.2.2 安全模式（仅允许可信控制器连接，2023.1及以上版本）

通过指定可信控制器证书指纹限制访问。指纹可从NeoLoad Controller的 编辑 > 偏好设置 > 高级 菜单获取（格式如SHA3-256/3ea7fd93a427a3b2c09e14f844e911efd87fc429804a3bbe259a81a8ae7399cf）：

bash
docker run -p 7100:7100 \
  -e ACCEPT_FINGERPRINTS=SHA3-256/3ea7fd93a427a3b2c09e14f844e911efd87fc429804a3bbe259a81a8ae7399cf \
  neotys/neoload-loadgenerator

4.2.3 连接NeoLoad Web（6.6及以上版本）

配置负载生成器接入NeoLoad Web平台，实现集中管理：

bash
docker run -p 7100:7100 \
  -e NEOLOADWEB_URL={nlweb-onpremise-apiurl:port} \
  -e NEOLOADWEB_TOKEN={nlweb-token} \
  -e ZONE={zone-id} \
  -e LG_HOST={load-generator-host} \
  -e LG_PORT=7100 \
  neotys/neoload-loadgenerator

示例（连接NeoLoad Web SaaS）：

bash
docker run -p 7100:7100 \
  -e NEOLOADWEB_TOKEN=myToken \
  -e ZONE=myZoneId \
  -e LG_HOST=lg.mycompany.com \
  -e LG_PORT=7100 \
  neotys/neoload-loadgenerator

4.2.4 Docker Compose示例（不安全模式）

创建docker-compose.yml：

yaml
version: '3'
services:
  neoload-loadgenerator:
    image: neotys/neoload-loadgenerator
    ports:
      - "7100:7100"
    environment:
      - AGENT_ACCEPT_ONLY=ALL

启动命令：docker-compose up -d

4.3 环境变量配置

4.4 注意事项

• 代理密码加密：若NEOLOADWEB_PROXY包含密码，可使用Tricentis密码加密工具加密，并添加前缀。
• 证书指纹获取：ACCEPT_FINGERPRINTS需从NeoLoad Controller的编辑 > 偏好设置 > 高级菜单复制，确保指纹格式正确。

5. 许可证

使用本镜像需同意Tricentis使用条款。许可证不允许进一步分发镜像。

6. 支持的Docker版本

• 官方支持：Docker 1.11.0及以上版本。
• 旧版本兼容：1.6及以上版本提供有限支持（尽力而为）。
• 升级说明：参考Docker安装文档升级Docker引擎。

7. 用户反馈

• 技术支持：通过Tricentis Support获取帮助。
• 社区论坛：在NeoLoad Community交流经验。