octoperf/jmeter-standard

OpenJDK + SSH + JMeter + OctoPerf Plugin 镜像文档

1. 镜像概述

1.1 核心组件

本镜像基于 Linux 系统构建，集成以下核心组件：

• OpenJDK：提供 Java 运行环境，支持 Java 应用程序执行及 JMeter 运行
• SSH 服务：支持远程登录容器，便于环境管理与测试脚本执行
• Apache JMeter：开源性能测试工具，用于负载测试、压力测试及接口性能评估
• OctoPerf Plugin：JMeter 插件，增强性能测试能力，支持云测试集成、高级报告分析及测试场景管理

1.2 主要用途

提供一站式 Java 应用性能测试环境，支持本地/远程测试执行、测试过程远程控制、集成 OctoPerf 高级测试功能，适用于快速搭建标准化性能测试平台。

2. 核心功能与特性

2.1 组件功能

• OpenJDK：预装 Java Development Kit，支持 Java 应用编译与运行，满足 JMeter 及 Java 测试脚本的执行依赖
• SSH 服务：内置 OpenSSH 服务，支持 SSH 密钥/密码认证，可远程登录容器执行测试命令、管理测试环境
• Apache JMeter：包含完整 JMeter 功能，支持 HTTP/HTTPS、数据库、消息队列等多种协议的性能测试，支持自定义测试脚本
• OctoPerf Plugin：提供 OctoPerf 云测试集成、分布式测试调度、实时性能监控、自动化报告生成（HTML/PDF）及测试数据可视化功能

2.2 整体特性

• 即开即用：预装所有依赖组件，无需手动配置环境
• 灵活配置：支持通过环境变量自定义 SSH 登录信息、JMeter 运行参数及 OctoPerf 插件配置
• 数据持久化：支持挂载外部目录存储测试脚本、测试报告及日志文件
• 兼容性：兼容主流 Linux 容器运行时（Docker、containerd）及云平台容器服务

3. 使用场景与适用范围

3.1 典型场景

• 性能测试工程师：快速搭建本地/远程 JMeter 测试环境，执行负载测试并通过 OctoPerf 生成专业报告
• CI/CD 集成：在持续集成/部署流程中嵌入性能测试步骤，通过 SSH 远程触发 JMeter 测试，确保应用发布前性能达标
• 远程测试管理：通过 SSH 远程控制容器内的测试进程，适用于分布式测试环境或需要跨网络管理测试节点的场景
• OctoPerf 高级功能应用：利用 OctoPerf 插件的云测试资源调度、测试场景版本控制及团队协作功能

3.2 适用用户

• 软件测试工程师、性能测试工程师
• 开发团队（需在开发流程中集成性能验证）
• DevOps 工程师（构建 CI/CD 性能测试流水线）
• 需要 OctoPerf 高级测试能力的企业用户

4. 使用方法与配置说明

4.1 镜像获取

假设镜像托管于 Docker Hub，拉取命令如下：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/openjdk-ssh-jmeter-octoperf:latest

4.2 快速启动（docker run）

基础启动命令

bash
docker run -d \
  --name jmeter-test-env \
  -p 2222:22 \  # SSH 端口映射（主机端口:容器端口）
  -p 8080:8080 \  # JMeter 图形界面端口（如需）
  -v /local/test/scripts:/jmeter/scripts \  # 挂载本地测试脚本目录
  -v /local/test/reports:/jmeter/reports \  # 挂载报告输出目录
  -e SSH_USER=testuser \  # SSH 登录用户名
  -e SSH_PASSWORD=testpass123 \  # SSH 登录密码
  -e JMETER_HEAP_SIZE=1024m \  # JMeter JVM 堆内存
  -e OCTOPERF_API_KEY=your_octoperf_api_key \  # OctoPerf API 密钥（可选）
  [镜像仓库地址]/openjdk-ssh-jmeter-octoperf:latest

4.3 Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  jmeter-env:
    image: docker.xuanyuan.run/[镜像仓库地址]/openjdk-ssh-jmeter-octoperf:latest
    container_name: jmeter-test-env
    ports:
      - "2222:22"       # SSH 端口
      - "8080:8080"     # JMeter 图形界面端口
      - "4445:4445"     # JMeter 分布式测试端口（如需）
    volumes:
      - ./test-scripts:/jmeter/scripts       # 测试脚本目录
      - ./test-reports:/jmeter/reports       # 报告输出目录
      - ./jmeter.properties:/jmeter/bin/jmeter.properties  # 自定义 JMeter 配置
    environment:
      - SSH_USER=testuser
      - SSH_PASSWORD=testpass123
      - JMETER_HEAP_SIZE=2048m
      - JMETER_THREADS=1000                  # 默认线程数（用于简化脚本）
      - OCTOPERF_API_KEY=your_octoperf_api_key
      - OCTOPERF_PROJECT_ID=your_project_id  # OctoPerf 项目 ID（可选）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

4.4 环境变量配置

4.5 SSH 服务配置

远程登录容器

bash
ssh [SSH_USER]@[主机IP] -p [主机映射的SSH端口]
# 示例：ssh testuser@192.168.1.100 -p 2222

密钥登录（推荐）

1. 生成本地 SSH 密钥对（如已存在可跳过）：

   bash
   ssh-keygen -t rsa -b 2048 -f ~/.ssh/jmeter_key
   

2. 将公钥 ~/.ssh/jmeter_key.pub 内容挂载至容器 ~/.ssh/authorized_keys：

   bash
   docker run -d \
     ... \
     -v ~/.ssh/jmeter_key.pub:/home/[SSH_USER]/.ssh/authorized_keys \
     ...
   

3. 免密登录：

   bash
   ssh -i ~/.ssh/jmeter_key [SSH_USER]@[主机IP] -p [SSH端口]
   

4.6 JMeter 与 OctoPerf 插件使用

执行本地测试脚本

通过 SSH 登录容器后，执行 JMeter 测试：

bash
cd /jmeter/bin
./jmeter -n -t /jmeter/scripts/test_plan.jmx -l /jmeter/reports/test_result.jtl -e -o /jmeter/reports/html

• -n：非 GUI 模式运行
• -t：指定测试计划文件（.jmx）
• -l：生成结果日志（.jtl）
• -e -o：生成 HTML 报告并输出至指定目录

集成 OctoPerf 云测试

1. 确保已配置 OCTOPERF_API_KEY 环境变量
2. 通过 OctoPerf 插件导出测试场景至 JMeter：

   bash
   ./jmeter -Joctoperf.api.key=$OCTOPERF_API_KEY -n -t /jmeter/scripts/octoperf_cloud_test.jmx
   

3. 测试结果将自动同步至 OctoPerf 平台，可登录 OctoPerf 查看实时报告与分析

5. 注意事项

• 数据持久化：测试脚本、报告等重要数据需通过 -v 挂载至主机目录，避免容器删除后数据丢失
• 安全建议：生产环境中建议使用 SSH 密钥认证（而非密码），并定期更换密钥；SSH_PASSWORD 应设置复杂密码
• 资源配置：根据测试规模调整 JMETER_HEAP_SIZE，高并发测试建议配置 2G 以上内存
• OctoPerf 插件更新：如需更新插件，可通过 jmeter-plugins-manager 执行：

  bash
  ./jmeter -Jplugins.manager.version=1.10 -n -t /jmeter/bin/PluginsManagerCMD.jmx -Jaction=install -Jplugins=octoperf-jmeter-plugin
  

• 端口冲突：确保主机映射端口（如 2222、8080）未被占用，可通过 netstat -tuln 检查端口占用情况