Locusts Docker Image

The locusts docker image is designed for easily composing multi-container locust.io load testing swarms using Python 3.6. The locusts image functions can function as either a master or worker depending on whether or not the --master-host flag is specified in a container's run execution call.

The docker image is available in Docker Hub. You can pull the image with the command:

$ docker pull swernst/locusts:latest

Master & Workers

The optional --master-host argument is used to specify that the container should be a worker and communicate with the master with the specified host. For example:

$ docker run -it --rm \
    -v ./scripts:/scripts \
    swernst/locusts \
    --master-host=127.0.0.1

would specify a worker container where the master resides at the local 127.0.0.1 host location.

Script Volume

A locusts container requires that a volume be mounted to the container's /scripts directory. It expects to find the locustfile.py to run in that directory.

Docker Compose

The multi-container environment is easily specified using docker compose. You can see an example in this repository of how that would look: docker-compose.yml