peter-evans/locust-docker

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

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