jplewes / docker-locust

Dockerfile for building Locust docker containers

docker-locust

Dockerfile to create Docker containers for Locust load testing tool.

Build or Image

You can either build your own image using the included Dockerfile or just pull the existing image from the Docker Index.

Build container:

$ docker build .

Pull image:

$ docker pull ryandub/locust

Usage

The following usage instructions assumes Docker >= 0.5.3 and your running user in the docker system group (to prevent needed sudo usage).

Run in Single node mode:

$ docker run -d -e host='http://<insert_target_host>' -v `pwd`/locustfiles:/opt/locustfiles ryandub/locust locust -f /opt/locustfiles/locustfile.py

Run as Master:

$ docker run -d -e host='http://<insert_target_host>' -p 8089:8089 -p 5557:5557 -p 5558:5558 -v `pwd`/locustfiles:/opt/locustfiles ryandub/locust locust --master -f /opt/locustfiles/locustfile.py

Run as Slave:

$ docker run -d -e host='http://<insert_target_host>' -v `pwd`/locustfiles:/opt/locustfiles ryandub/locust locust --slave --master-host=<ip_of_docker_host> -f /opt/locustfiles/locustfile.py

The locustfile.py included is just an example that uses an evironment variable to load information. To use your own locustfile, just change -v `pwd`/locustfiles:/opt/locustfiles to point to your own locustfile.

Once your master/standalone container is running, connect to your Docker host on 8089 to access the webui.