/locust-docker

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

Primary LanguageShellMIT LicenseMIT

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