Skip to content

Latest commit

 

History

History
44 lines (31 loc) · 1.98 KB

README.md

File metadata and controls

44 lines (31 loc) · 1.98 KB

Locust Docker

CircleCI

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

Supported tags and respective Dockerfile links

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