grubykarol/locust

!pulls !stars

镜像概述

本镜像旨在提供：

• 使用Python 3.x版本
• 集成最新版Locust
• 体积尽可能小
• 操作简单
• 通过挂载卷方式加载Locust脚本

由于Docker Hub上多数同类镜像较旧（1-2年未更新），因此创建此镜像。它基于Alpine系统的Python镜像构建，安装locustio包及必要依赖，体积约130MB。

仓库结构与镜像标签

Git项目按多版本管理设计，标签系统用于区分不同版本组件。

仓库结构

文件夹结构如下：

.
├── locust版本a
│   ├── Python版本x
│   │   ├── OS版本1
│   │   └── OS版本2
│   └── Python版本y
│       ├── OS版本1
│       └── OS版本2
├── locust版本b
...

其中：

• locust版本：具体Locust版本（如0.10.0）
• Python版本：具体Python版本（如3.6）
• OS版本：具体操作系统版本（如alpine3.9）

标签结构

标签反映目录结构，包含所有组件信息：

• Locust版本
• Python版本
• OS版本

例如，Locust 0.10.0 + Python3.6 + Alpine3.9的镜像路径为：

\0.10.0\python3.6\alpine3.9

对应的镜像标签为：grubykarol/locust:0.10.0-python3.6-alpine3.9

使用说明

Docker Hub地址：https://hub.docker.com/r/grubykarol/locust

镜像构建时不包含Locust脚本，需在运行时通过挂载卷（到/locust路径）提供脚本，支持同一镜像用于不同场景，无需基于此镜像二次构建仅添加脚本。

拉取镜像

拉取最新稳定版：

bash
docker pull grubykarol/locust

或指定Locust、Python、OS版本：

bash
docker pull grubykarol/locust:1.2.3-python3.9-alpine3.12

运行镜像

镜像通过环境变量配置行为：

单机模式

基本运行（$MY_SCRIPTS路径下含locustfile.py）：

bash
docker run --rm --name standalone --hostname standalone -e ATTACKED_HOST=http://standalone:8089 -p 8089:8089 -d -v $MY_SCRIPTS:/locust grubykarol/locust

无UI模式运行：

bash
docker run --rm --name standalone --hostname standalone -e ATTACKED_HOST=http://example.com -e "LOCUST_OPTS=--no-web" -d -v $MY_SCRIPTS:/locust grubykarol/locust

主从模式

启动主节点：

bash
docker run --name master --hostname master \
 -p 8089:8089 -p 5557:5557 -p 5558:5558 \
 -v $MY_SCRIPTS:/locust \
 -e ATTACKED_HOST=http://master:8089 \
 -e LOCUST_MODE=master \
 --rm -d grubykarol/locust

启动工作节点：

bash
docker run --name worker0 \
 --link master --env NO_PROXY=master \
 -v $MY_SCRIPTS:/locust \
 -e ATTACKED_HOST=http://master:8089 \
 -e LOCUST_MODE=worker \
 -e LOCUST_MASTER=master \
 --rm -d grubykarol/locust

docker run --name worker1 \
 --link master --env NO_PROXY=master \
 -v $MY_SCRIPTS:/locust \
 -e ATTACKED_HOST=http://master:8089 \
 -e LOCUST_MODE=worker \
 -e LOCUST_MASTER=master \
 --rm -d grubykarol/locust

Windows PowerShell版本

基本运行：

powershell
docker run --rm --name standalone `
 -e ATTACKED_HOST=http://localhost:8089 `
 -v c:\locust-scripts:/locust `
 -p 8089:8089 -d `
 grubykarol/locust

启动主节点：

powershell
docker run --name master --hostname master `
 -p 8089:8089 -p 5557:5557 -p 5558:5558 `
 -v c:\locust-scripts:/locust `
 -e ATTACKED_HOST='http://master:8089' `
 -e LOCUST_MODE=master `
 --rm -d grubykarol/locust

启动工作节点：

powershell
docker run --name worker0 `
 --link master --env NO_PROXY=master `
 -v c:\locust-scripts:/locust `
 -e ATTACKED_HOST=http://master:8089 `
 -e LOCUST_MODE=worker `
 -e LOCUST_MASTER=master `
 --rm -d grubykarol/locust

示例

更多示例位于examples目录，包含单机/分布式压测的docker-compose文件，详见该目录说明。

构建镜像

进入目标版本目录（参考仓库结构），执行构建：

bash
docker build -t grubykarol/locust:1.2.3-python3.9-alpine3.12 .

若在代理环境下（已设置HTTP(S)_PROXY变量）：

bash
docker build --build-arg HTTP_PROXY=$http_proxy --build-arg HTTPS_PROXY=$https_proxy -t grubykarol/locust:1.2.3-python3.9-alpine3.12 .

开发用脚本build-all.sh可批量构建所有或指定Locust版本的镜像（脚本较简单，仅供开发使用）。