从零搭建到一键部署：手把手教你用Docker Compose搞定Easy-Jmeter性能测试平台

从零搭建到一键部署手把手教你用Docker Compose搞定Easy-Jmeter性能测试平台性能测试是软件开发过程中不可或缺的一环但传统JMeter部署的复杂性常常让团队望而却步。本文将带你从零开始通过Docker Compose快速搭建一个完整的Easy-Jmeter性能测试平台解决环境依赖复杂、部署困难等痛点。1. 环境准备与基础概念在开始部署之前我们需要了解几个关键组件及其作用JMeterApache开源的压力测试工具支持多种协议的性能测试Easy-Jmeter基于JMeter的二次开发平台提供了更友好的Web界面和集中管理功能Docker Compose用于定义和运行多容器Docker应用程序的工具为什么选择容器化部署传统部署方式需要手动安装和配置MySQL、MongoDB、InfluxDB、MinIO等多个服务不仅耗时耗力还容易因环境差异导致各种问题。容器化部署具有以下优势环境隔离各服务运行在独立的容器中互不干扰快速部署一键启动所有依赖服务版本控制可以精确控制各服务版本易于迁移配置一次随处运行2. 部署前准备工作2.1 系统要求确保你的系统满足以下最低要求操作系统Linux (推荐Ubuntu 20.04) 或 macOSDocker版本20.10.0Docker Compose版本1.29.0硬件CPU4核以上内存8GB以上磁盘空间20GB以上2.2 安装Docker和Docker Compose如果你的系统尚未安装Docker可以按照以下步骤安装# 安装Docker curl -fsSL https://get.docker.com | sh sudo systemctl start docker sudo systemctl enable docker # 安装Docker Compose sudo curl -L https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose验证安装是否成功docker --version docker-compose --version3. 配置Docker Compose文件Easy-Jmeter平台依赖多个服务我们需要创建一个docker-compose.yaml文件来定义这些服务。以下是完整的配置示例version: 3.8 services: mysql: image: mysql:5.7 container_name: ej-mysql environment: MYSQL_ROOT_PASSWORD: easyjmeter MYSQL_DATABASE: easyjmeter volumes: - mysql_data:/var/lib/mysql ports: - 3306:3306 restart: always mongodb: image: mongo:4.2 container_name: ej-mongodb volumes: - mongodb_data:/data/db ports: - 27017:27017 restart: always influxdb: image: influxdb:1.8 container_name: ej-influxdb environment: - INFLUXDB_DBjmeter volumes: - influxdb_data:/var/lib/influxdb ports: - 8086:8086 restart: always minio: image: minio/minio container_name: ej-minio command: server /data environment: - MINIO_ROOT_USERminioadmin - MINIO_ROOT_PASSWORDminioadmin volumes: - minio_data:/data ports: - 9000:9000 - 9001:9001 restart: always server: build: ./api container_name: ej-server depends_on: - mysql - mongodb - influxdb - minio environment: - SPRING_DATASOURCE_URLjdbc:mysql://mysql:3306/easyjmeter - SPRING_DATASOURCE_USERNAMEroot - SPRING_DATASOURCE_PASSWORDeasyjmeter - SPRING_DATA_MONGODB_URImongodb://mongodb:27017/easyjmeter - INFLUXDB_URLhttp://influxdb:8086 - INFLUXDB_DBjmeter - MINIO_URLhttp://minio:9000 - MINIO_ACCESS_KEYminioadmin - MINIO_SECRET_KEYminioadmin - SOCKET_SERVER_ENABLEtrue ports: - 8080:8080 restart: always web: build: ./web container_name: ej-web depends_on: - server ports: - 80:80 restart: always volumes: mysql_data: mongodb_data: influxdb_data: minio_data:3.1 关键配置解析数据库服务MySQL存储平台基础数据MongoDB存储测试结果详细数据InfluxDB存储压测过程中的实时数据MinIO用于存储测试脚本、数据文件和结果文件默认创建了一个公开的bucket用于文件访问Server服务后端服务基于Spring Boot连接所有数据库和存储服务启用了Socket.IO服务用于与Agent通信Web服务前端服务基于Vue.js通过Nginx提供Web访问4. 部署与启动4.1 获取Easy-Jmeter源码首先克隆Easy-Jmeter的GitHub仓库git clone https://github.com/guojiaxing1995/easy-jmeter.git cd easy-jmeter4.2 构建并启动服务使用以下命令构建镜像并启动所有服务docker-compose up -d --build这个过程可能需要一些时间具体取决于你的网络速度和系统性能。完成后你可以使用以下命令检查服务状态docker-compose ps4.3 验证服务所有服务启动后可以通过以下方式验证Web界面访问http://localhost应该能看到Easy-Jmeter的登录界面API服务访问http://localhost:8080/swagger-ui.html可以查看API文档MinIO管理界面访问http://localhost:9001使用minioadmin/minioadmin登录5. 配置压力机Agent平台的核心功能之一是分布式压测这需要通过Agent来控制各个压力机上的JMeter实例。5.1 安装Agent在每台压力机上执行以下步骤安装Java运行环境JRE 8安装JMeter并设置JMETER_HOME环境变量下载Agent jar包并运行java -jar easy-jmeter-agent.jar --serverUrlhttp://server-ip:80805.2 验证Agent连接在Web界面的压力机管理页面应该能看到新注册的压力机。状态显示为在线表示连接成功。6. 平台使用指南6.1 创建第一个测试项目登录Web界面默认账号admin/admin导航到项目管理点击新增填写项目名称和描述保存6.2 上传测试脚本在用例管理页面点击新增用例选择项目填写用例名称上传JMX脚本和所需的CSV数据文件6.3 执行性能测试在用例列表中找到目标用例点击启动测试配置测试参数并发线程数压测时长压力机数量点击启动开始测试6.4 监控测试过程测试开始后可以在测试详情页面查看实时TPS和响应时间错误率统计压力机状态7. 常见问题排查7.1 服务启动失败如果某些服务无法启动可以查看日志定位问题docker-compose logs service-name常见问题包括端口冲突修改docker-compose.yaml中的端口映射权限问题确保Docker有足够的权限访问挂载卷7.2 Agent连接问题如果Agent无法连接到Server检查Server的Socket.IO服务是否启用SOCKET_SERVER_ENABLEtrue网络连通性防火墙是否阻止了8080端口Agent配置的Server URL是否正确7.3 性能问题如果测试过程中出现性能瓶颈可以考虑增加压力机数量调整JMeter的JVM参数优化测试脚本减少不必要的断言和监听器8. 进阶配置与优化8.1 数据持久化默认配置中我们使用了Docker卷来持久化数据。对于生产环境你可能需要备份策略定期备份MySQL和MongoDB数据设置MinIO的版本控制外部存储将数据库数据挂载到外部存储系统使用云存储服务替代MinIO8.2 性能调优JMeter配置修改jmeter.properties提高性能使用命令行模式运行测试平台配置调整JVM参数优化Server性能配置数据库连接池大小8.3 安全加固修改默认密码MySQL root密码MinIO访问密钥平台管理员密码网络隔离将服务部署在内网配置防火墙规则限制访问HTTPS支持为Web界面配置SSL证书启用API服务的HTTPS9. 平台功能扩展Easy-Jmeter平台具有良好的扩展性你可以考虑以下增强集成Grafana使用Grafana展示更丰富的性能指标创建自定义的监控仪表盘添加报警功能当测试出现错误或性能不达标时发送通知支持邮件、Slack等多种通知方式CI/CD集成将性能测试集成到持续交付流程中设置性能基准和自动验证自定义报告生成更符合团队需求的测试报告添加业务相关的性能指标分析10. 最佳实践与经验分享在实际使用中我们发现以下实践能显著提升效率测试脚本管理使用版本控制系统管理JMX脚本建立脚本模板库避免重复工作测试数据准备使用CSV文件参数化测试数据开发数据生成工具快速创建测试数据测试策略先进行小规模测试验证脚本正确性逐步增加负载观察系统表现进行长时间稳定性测试结果分析关注错误率、响应时间百分位数对比历史测试结果评估系统变化团队协作建立性能测试规范定期进行性能测试评审分享性能优化经验