smithmicro/jmeter

ECS用JMeter镜像

本镜像用于在Amazon EC2容器服务（ECS）上进行分布式测试，包含两个核心镜像：

• smithmicro/jmeter：部署在ECS中的JMeter软件本体
• smithmicro/lucy：可在企业防火墙后运行的编排镜像，负责管理AWS资源

警告：使用本镜像会产生AWS计算和存储费用。尽管测试完成后会终止所有实例和卷，但可能存在bug导致资源持续运行，请查看问题列表了解详情。

如何使用

smithmicro/lucy镜像可通过环境变量配置运行，需满足以下前提条件：

1. 创建包含至少一个子网的VPC（ECS必需）
2. 创建允许22、1099、50000、51000（TCP）和4445（UDP）端口的VPC安全组
3. 创建密钥对并放置在keys子目录
4. 准备AWS CLI访问密钥ID和秘密访问密钥
5. 替换或编辑plans/demo.jmx以运行特定测试
6. 确保存在ecsInstanceRole角色（ECS首次运行时自动创建，详情见官方文档）

若未创建VPC，可使用附带的aws-setup.sh脚本创建VPC、子网和所需安全组。

Docker运行模板

bash
docker run -v <jmx文件路径>:/plans -v <pem文件路径>:/keys -v <日志路径>:/logs \
    --env AWS_ACCESS_KEY_ID=<密钥ID> \
    --env AWS_SECRET_ACCESS_KEY=<秘密密钥> \
    --env AWS_DEFAULT_REGION=<区域> \
    --env SECURITY_GROUP=<VPC内的安全组> \
    --env SUBNET_ID=<VPC内的子网ID（逗号分隔）> \
    --env KEY_NAME=<密钥对名称（不含.pem扩展名）> \
    --env MINION_COUNT=<测试实例数量> \
    smithmicro/lucy /plans/demo.jmx

示例（美国东部弗吉尼亚区域5个测试实例）

假设jmeter-key.pem位于keys子目录：

bash
docker run -v $PWD/plans:/plans -v $PWD/keys:/keys -v $PWD/logs:/logs \
    --env AWS_ACCESS_KEY_ID=ABCDEFGHIJKLMNOPQRST \
    --env AWS_SECRET_ACCESS_KEY=abcdefghijklmnopqrstuvwxyz0123456789ABCDEF \
    --env AWS_DEFAULT_REGION=us-east-1 \
    --env SECURITY_GROUP=sg-12345678 \
    --env SUBNET_ID=subnet-12345678,subnet-87654321 \
    --env KEY_NAME=jmeter-key \
    --env MINION_COUNT=5 \
    smithmicro/lucy /plans/demo.jmx

架构

本镜像将JMeter的主从架构替换为Gru（管理ECS内的Minion）、Minion（执行测试任务）和Lucy（编排整个流程）三个角色：

+--------------------------------------+
|  EC2                                 |
|  +--------------------------------+  |
|  |  ECS                           |  |
|  |                +--------+      |  |
|  |  +-------+     | +--------+    |  |      +--------+
|  |  |       |---->| | +--------+ ---------->|        |
|  |  |  Gru  |<----| | |        | ---------->| Target |
|  |  |       |     +-| | Minion | ---------->|        |
|  |  +-------+       +-|        |  |  |      +--------+
|  |     ^ |            +--------+  |  |
|  +-----|-|------------------------+  |
+--------|-|---------------------------+
         | |
    .jmx | | .log/.jtl
         | v
     +----------+
     |          |
     |   Lucy   |
     |          |
     +----------+

Lucy通过lucy.sh脚本执行以下步骤：

1. 创建ECS集群
2. 等待所有容器实例注册完成
3. 运行指定数量的Minion任务
4. 获取Gru和Minion的实例ID
5. 获取Gru和Minion的IP地址
6. 复制文件到Minion/Gru（或仅复制JMX）
7. 运行Gru执行指定JMX测试
8. 从Gru获取测试结果
9. 删除集群

卷

Lucy容器使用以下3个卷：

• /plans：映射JMX测试文件
• /keys：映射PEM密钥文件
• /logs：映射输出日志（jmeter.log）和结果文件（results.jtl）

环境变量

支持以下必填和可选环境变量：

注意事项

• 所有JMeter插件通过插件管理器安装
• 分布式测试详情见JMeter官方文档

灵感来源

《神偷奶爸2》

!Minions