anasoid/jmeter

Docker-JMeter 镜像文档

镜像概述和主要用途

Docker-JMeter 是一个在 Docker 环境中运行 Apache JMeter 的高级镜像解决方案，提供了丰富的功能特性，简化了性能测试的部署与执行流程。该镜像旨在通过容器化方式确保 JMeter 运行环境的一致性，同时支持多种配置选项以满足不同测试场景需求。

镜像可在 https://hub.docker.com/r/anasoid/jmeter 获取。

镜像版本说明

JMeter 5.6

基础版本（无插件）

• JRE 环境：
  • latest, 5.6, 5.6-21-jre, 5.6.0, 5.6.3-21-jre
  • 5.6-17-jre, 5.6.3-17-jre
  • 5.6-11-jre, 5.6.3-11-jre
• JDK 环境：
  • latest-21-jdk, 5.6-21-jdk, 5.6.3-21-jdk
  • 5.6-17-jdk, 5.6.3-17-jdk
  • 5.6-11-jdk, 5.6.3-11-jdk

带插件版本（预配置插件管理器）

• JRE 环境：
  • latest-plugins, 5.6-plugins, 5.6-plugins-21-jre, 5.6.3-plugins, 5.6.3-plugins-21-jre
  • 5.6-plugins-17-jre, 5.6.3-plugins-17-jre
  • 5.6-plugins-11-jre, 5.6.3-plugins-11-jre
• JDK 环境：
  • latest-plugins-21-jdk, 5.6-plugins-21-jdk, 5.6.3-plugins-21-jdk
  • 5.6-plugins-17-jdk, 5.6.3-plugins-17-jdk
  • 5.6-plugins-11-jdk, 5.6.3-plugins-11-jdk

JMeter 5.5

基础版本（无插件）

• JRE 环境：5.5, 5.5-21-jre, 5.5-17-jre, 5.5-11-jre
• JDK 环境：5.5-21-jdk, 5.5-17-jdk, 5.5-11-jdk

带插件版本（预配置插件管理器）

• JRE 环境：5.5-plugins, 5.5-plugins-21-jre, 5.5.0-plugins, 5.5.0-plugins-21-jre, 5.5-plugins-17-jre, 5.5.0-plugins-17-jre, 5.5-plugins-11-jre, 5.5.0-plugins-11-jre
• JDK 环境：5.5-plugins-21-jdk, 5.5.3-plugins-21-jdk, 5.5-plugins-17-jdk, 5.5.3-plugins-17-jdk, 5.5-plugins-11-jdk, 5.5.3-plugins-11-jdk

JMeter 5.4

基础版本（无插件）

• JRE 环境：5.4, 5.4-11-jre, 5.4.3, 5.4.3-11-jre
• JDK 环境：5.4-11-jdk, 5.4.3-11-jdk

带插件版本（预配置插件管理器）

• JRE 环境：5.4-plugins, 5.4-plugins-11-jre, 5.4.3-plugins, 5.4.3-plugins-11-jre
• JDK 环境：5.4-plugins-11-jdk, 5.4.3-plugins-11-jdk

所有版本均基于 https://github.com/anasoid/docker-jmeter/blob/master/5.x/eclipse-temurin/Dockerfile 构建。

核心功能和特性

1. 最小镜像大小约 110MB，资源占用低
2. 支持 ARM64 架构（仅 JVM 21 版本），可在 Oracle 永久免费虚拟机上运行
3. 提供两种版本：原生 JMeter 版本和预配置插件管理器的版本
4. 执行超时控制：超时后自动停止容器，即使测试未完成，便于强制终止长时间运行的测试
5. 支持通过 Maven 依赖格式下载插件
6. 支持通过 URL 列表下载插件
7. 支持通过插件管理器下载插件（仅插件版本）
8. 支持从文件夹加载插件
9. JMX 测试计划验证（仅插件版本）
10. 多节点环境下的 CSV 数据拆分
11. 支持执行测试前/后 shell 脚本
12. 项目配置与节点配置分离，便于开发团队与执行团队协作
13. 输出目录（日志、JTL 文件、HTML 报告）隔离
14. 支持所有 JMeter 原生参数，无功能限制
15. 支持基于文件存在性检查的延迟执行
16. 支持通过 Jolokia 监控 JMX 指标（仅 JDK 版本）

使用场景和适用范围

1. CI/CD 流程集成：在持续集成/持续部署 pipeline 中自动执行性能测试，确保代码变更不会引入性能问题
2. 跨平台环境一致性：在开发、测试、生产等不同环境中提供一致的 JMeter 运行环境，避免环境差异导致的测试结果偏差
3. 分布式性能测试：结合 Docker Swarm 或 Kubernetes 实现多节点分布式测试，模拟高并发场景
4. 临时测试环境：快速部署和销毁 JMeter 环境，适用于临时性能验证需求
5. 资源受限环境：轻量级镜像设计，适合在资源有限的环境（如边缘计算节点）中运行
6. 自动化测试报告生成：通过容器化执行自动生成测试报告并持久化存储

使用方法和配置说明

基本用法

执行 JMeter 测试计划

通过挂载本地测试脚本（JMX 文件）到容器中，执行性能测试：

bash
docker run -v /path/to/local/test.jmx:/jmeter/test.jmx \
           -v /path/to/output:/jmeter/output \
           anasoid/jmeter:latest \
           -n -t /jmeter/test.jmx -l /jmeter/output/result.jtl -e -o /jmeter/output/report

• -v /path/to/local/test.jmx:/jmeter/test.jmx：挂载本地 JMX 测试计划到容器内
• -v /path/to/output:/jmeter/output：挂载本地目录用于存储测试结果（JTL 文件）和 HTML 报告
• -n：非 GUI 模式运行
• -t /jmeter/test.jmx：指定测试计划路径
• -l /jmeter/output/result.jtl：指定结果日志文件
• -e -o /jmeter/output/report：生成 HTML 报告并输出到指定目录

查看 JMeter 版本信息

bash
docker run --rm anasoid/jmeter:latest -v

高级配置

自定义 JMeter 参数

所有 JMeter 命令行参数均可直接传递给容器，例如设置线程数、循环次数等：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           anasoid/jmeter:latest \
           -n -t /jmeter/test.jmx -Jthreads=100 -Jloop=50 -l result.jtl

使用插件版本

如需使用预安装插件管理器的版本，选择带 plugins 标签的镜像，例如：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           anasoid/jmeter:latest-plugins \
           -n -t /jmeter/test.jmx -l result.jtl

安装额外插件

通过 Maven 依赖格式安装插件（需插件版本）：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           anasoid/jmeter:latest-plugins \
           -n -t /jmeter/test.jmx \
           -Jplugins.download="org.apache.jmeter:jmeter-plugin-http:5.6"

通过 URL 列表安装插件：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           anasoid/jmeter:latest-plugins \
           -n -t /jmeter/test.jmx \
           -Jplugins.urls="https://example.com/plugin1.jar,https://example.com/plugin2.jar"

超时控制

设置测试执行超时时间（单位：秒），超时后容器自动停止：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           -e JMETER_TIMEOUT=3600 \
           anasoid/jmeter:latest \
           -n -t /jmeter/test.jmx -l result.jtl

延迟执行

通过检查文件存在性实现延迟执行（等待 /jmeter/wait-for-file 文件创建后开始测试）：

bash
docker run -v /path/to/test.jmx:/jmeter/test.jmx \
           -v /path/to/wait-file:/jmeter/wait-for-file \
           anasoid/jmeter:latest \
           -n -t /jmeter/test.jmx -l result.jtl

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义 JMeter 服务及持久化卷：

yaml
version: '3.8'

services:
  jmeter:
    image: anasoid/jmeter:latest-plugins
    volumes:
      - ./test-plans:/jmeter/test-plans      # 挂载测试计划目录
      - ./output:/jmeter/output              # 挂载输出目录
      - ./scripts:/jmeter/scripts            # 挂载前置/后置脚本目录
    environment:
      - JMETER_TIMEOUT=3600                  # 超时时间（秒）
    command: >
      -n 
      -t /jmeter/test-plans/load-test.jmx 
      -l /jmeter/output/result.jtl 
      -e -o /jmeter/output/report 
      -Jthreads=200 
      -Jduration=600

启动服务：

bash
docker-compose up

帮助与支持

• 问题反馈：https://github.com/anasoid/docker-jmeter/issues
• 讨论交流：https://github.com/anasoid/docker-jmeter/discussions
• 完整文档：https://github.com/anasoid/docker-jmeter