Locust Docker

Docker image for the Locust load testing tool and sample Kubernetes configuration files for distributed deployment.

Supported tags and respective Dockerfile links

• 1.2.2, 1.2, latest (1.2/Dockerfile)
• 1.2.2-python2, 1.2-python2, python2 (1.2/python2/Dockerfile)
• 1.1.1, 1.1 (1.1/Dockerfile)
• 1.1.1-python2, 1.1-python2 (1.1/python2/Dockerfile)
• 1.0.1, 1.0 (1.0/Dockerfile)

Usage

The Docker image can be run standalone by passing a URL to your locustfile:

docker run -d -p 8089:8089 \
-e LOCUST_LOCUSTFILE_URL='https://example.com/locustfile.py' \
-e LOCUST_TARGET_HOST='http://example.com' \
--name locust peterevans/locust:latest

Then point your web browser to http://localhost:8089/

Kubernetes Deployment

1. Create a ConfigMap containing your locustfile.py and its dependencies. The command below creates a ConfigMap containing files placed in the local directory locust-tasks.

   kubectl create configmap locust-configmap --from-file=locust-tasks/

2. Edit the deployment configuration files and set environment variable LOCUST_TARGET_HOST.

3. Deploy the master and slave deployments.

   kubectl create -f ./locust-master.yaml
   kubectl create -f ./locust-slave.yaml

License

MIT License - see the LICENSE file for details