Dockerfile to create Docker containers for Locust load testing tool.

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

$ docker build .

$ docker pull ryandub/locust

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

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

$ 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

$ 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.