tenrero/jmeterdistributed repository overview

⁠jmeterDistributed

Docker Image with Jmeter and OpenJDK JRE based on Linux Alpine specially designed for distributed load testing.

⁠Building the image

In order to build the image, you should run the following command:

docker build -t mtenrero/jmeter -t mtenrero/jmeter:latest -t mtenrero/jmeter:3.3 .

Please, bear in mind that the tags :latest and :3.3 represents the version of Jmeter you're installing into the image.

⁠Running the image

The image can be started in two modes:

• Master Represents the main instance of Jmeter, and should be started after the nodes. Also a environment variable REMOTES should be specified in the docker run command with the list of all available remotes to use by the master.

docker run -it -v $(pwd)/test:/test -e MODE="master" -e TEST_PATH="test.jmx" -e REMOTES="hosts" -p 6666:6666 mtenrero/jmeter

• Node It's a worker in the distributed load testing process.

docker run -d -e MODE="node" -p 7000:7000 -p 1099:1099 -p 4445:4445 mtenrero/jmeter

⁠Docker Compose

Docker Compose is the easiest way to try the configuration locally. You only need to specify the test name without the JMX extension in the enviroment variable TEST_NAME and put the file under the test folder within the root docker-compose folder.

If you need simulate multiple nodes, clone the slaves in the docker-compose file and make sure that they are declared in the REMOTES env.

TEST_NAME=<JMX_FULL_FILE_PATH> docker-compose up

⁠Ports

• 4445 Jmeter communication port
• 7777 RMI Port
• 1099 Master Port

⁠Roadmap

• Basic Image for running distributed tests
• Docker-compose for local debugging
• Publish to Docker Hub
• CI/CD
• Docker-compose v3 improvements
• Docker Swarm Mode with distributed execution
• Fix non-ending slaves