getcarrier/performance

镜像概述

Carrier定制的JMeter容器镜像，用于执行性能测试并生成多类型测试报告，支持与监控、报告工具集成，适用于本地测试或CI/CD流水线场景。

核心功能

• 执行JMeter性能测试，生成HTML报告、JTL结果文件及JUnit XML报告
• 支持与InfluxDB集成存储测试数据
• 向Loki发送错误请求信息
• 可配置向Report Portal或Jira提交测试结果及问题
• 从Galloper对象存储获取测试文件及插件

使用场景

1. 本地性能测试：快速运行JMeter测试并查看报告
2. CI/CD流水线：在Jenkins等工具中集成性能测试步骤
3. 分布式测试：结合对象存储管理测试资源，支持团队协作

配置说明

Docker标签与版本

• getcarrier/perfmeter:1.0：稳定发布版本1.0
• getcarrier/perfmeter:latest：开发版本，不建议生产环境使用

快速开始

1. 安装Docker

2. 启动容器并传递配置参数

示例Docker命令：

docker run --rm -u 0:0 \
       -v <本地测试文件路径>:/mnt/jmeter/ \
       -v <本地配置文件路径/config.yaml>:/tmp/ \ # 可选
       -v <本地报告存储路径>:/tmp/reports \ # 可选
       -e "env=<环境标识>" \ # 可选，默认'demo'
       -e "test_type=<测试类型>" \ # 可选，默认'demo'
       -e "loki_host=http://loki" \ # Loki主机或IP
       -e "loki_port=3100" \ # 可选，默认3100
       -e "JVM_ARGS='-Xms1g -Xmx2g'" \
       getcarrier/perfmeter:latest \
       -n -t /mnt/jmeter/<测试文件名> \
       -q /mnt/jmeter/<属性文件> # 可选

参数说明：

• <本地报告存储路径>：本地存储测试报告的路径
• <本地测试文件路径>：本地存放JMeter测试文件的路径
• <测试类型>：用于过滤测试结果的标签（可选）
• <环境标识>：用于过滤测试结果的标签（可选）
• <测试文件名>：要执行的JMeter测试文件名称
• <属性文件>：配置参数文件（可选）

3. 查看测试报告

报告存储在<本地报告存储路径>中（若已挂载），包含：

• jmeter.log：主日志文件
• jmeter.jtl：CSV格式的测试结果
• HtmlReport：JMeter默认HTML报告

配置文件

properties文件示例（parameters.txt）

influx.port=8086
influx.db=jmeter
influx.host=carrier_influx
comparison_db=comparison
lg.id=debug
DURATION=20
VUSERS=5
RAMP_UP=1
test_name=test
project.id=demo
test.type=demo
env.type=demo

也可通过命令行-J参数传递参数，例如：

... -t /mnt/jmeter/<测试文件名> -JVUSERS=1 -JRAMP_UP=1 ...

config.yaml文件示例（错误报告配置）

# 报告配置部分（所有报告类型均为可选）
#reportportal:                                        # ReportPortal.io配置
#  rp_host: https://rp.com                            # 部署地址
#  rp_token: XXXXXXXXXXXXX                            # 认证令牌
#  rp_project_name: XXXXXX                            # 目标项目名称
#  rp_launch_name: XXXXXX                             # 启动名称
#  check_functional_errors: False                     # 是否分析功能错误（默认False）
#  check_performance_degradation: False               # 是否分析性能退化（默认False）
#  check_missed_thresholds: False                     # 是否分析阈值超标（默认False）
#  performance_degradation_rate: 20                   # 性能退化阈值（默认20）
#  missed_thresholds_rate: 50                         # 阈值超标阈值（默认50）
#jira:
#  url: https://jira.com                              # Jira地址
#  username: some.dude                                # 用户名
#  password: password                                 # 密码
#  jira_project: XYZC                                 # 项目ID
#  assignee: some.dude                                # 默认经办人
#  issue_type: Bug                                    # 问题类型（默认Bug）
#  labels: Performance, perfmeter                     # 标签列表
#  watchers: another.dude                             # 观察者列表
#  jira_epic_key: XYZC-123                            # Epic Key
#  check_functional_errors: False                     # 是否分析功能错误（默认False）
#  check_performance_degradation: False               # 是否分析性能退化（默认False）
#  check_missed_thresholds: False                     # 是否分析阈值超标（默认False）
#  performance_degradation_rate: 20                   # 性能退化阈值（默认20）
#  missed_thresholds_rate: 50                         # 阈值超标阈值（默认50）
#influx:
#  host: carrier_influx                               # InfluxDB主机
#  port: 8086                                         # 端口（默认8086）
#  jmeter_db: jmeter                                  # 测试结果数据库（默认jmeter）
#  comparison_db: comparison                          # 对比数据库（默认comparison）
#loki:
#  host: http://loki                                  # Loki主机
#  port: 3100                                         # 端口

Jenkins流水线示例

def get_influx_host(String env_var) {
    def match = env_var =~ 'http://(.+)/jenkins'
    return match[0][1]
}

node{
    stage("配置") {
        deleteDir()
        sh "mkdir reports"
    }
    stage("运行测试") {
        def dockerParamsString = "--entrypoint=''"
        def params = [ "-t" ]
        for (param in params) { dockerParamsString += " ${param}" }
        docker.image("getcarrier/perfmeter:latest").inside(dockerParamsString){
            sh "mkdir /tmp/reports"
            sh """cd / && /launch.sh -n -t /mnt/jmeter/FloodIO.jmx \\
                  -Jinflux.host=${get_influx_host(env.JENKINS_URL)} \\
                  -JVUSERS=10 -JDURATION=120 -Jinflux.db=jmeter -Jinflux.port=8086 \\
                  -JRAMP_UP=1 -Jtest_name=test -Jbuild.id=flood_io_${JOB_NAME}_${BUILD_ID} \\
                  -Jproject.id=demo -Jtest.type=demo -Jenv.type=demo"""
            sh "mv /tmp/reports/* ${WORKSPACE}/reports/"
        }
    }
    stage("发布结果") { perfReport 'reports/*.jtl' }
}

从对象存储获取测试文件

前提：创建Galloper Bucket

1. 打开Galloper地址（如http://{{ galloper_url }}）
2. 点击侧边栏"Artifacts" → 创建Bucket（如jmeter）

运行测试命令

docker run --rm -t -u 0:0 \
        -e galloper_url="http://{{ galloper_url }}" \
        -e bucket="jmeter" -e artifact="{{ 测试文件.zip }}" \
        getcarrier/perfmeter:latest \
        -n -t /mnt/jmeter/{{ 测试文件名.jmx }} \
        -Jinflux.host={{ influx主机或IP }}

上传额外插件

docker run --rm -t -u 0:0 \
       -e galloper_url="http://{{ galloper_url }}" \
       -e additional_files='{"jmeter/InfluxBackendListenerClient.jar": "/jmeter/apache-jmeter-5.0/lib/ext/InfluxBackendListenerClient.jar"}' \
       getcarrier/perfmeter:latest \
       -n -t /mnt/jmeter/{{ 测试文件名.jmx }} \
       -Jinflux.host={{ influx主机或IP }}