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.6.3, 1.6, latest, 1.6.3-locustio0.14.5, 1.6-locustio0.14.5, latest-locustio0.14.5 (1.6/Dockerfile)
• 1.6.2, 1.6, latest, 1.6.2-locustio0.14.4, 1.6-locustio0.14.4, latest-locustio0.14.4 (1.6/Dockerfile)
• 1.6.1, 1.6 (1.6/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