Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/peter-evans/locust-docker

Docker image for the Locust load testing tool and sample Kubernetes configuration files for distributed deployment.
https://github.com/peter-evans/locust-docker

docker-image kubernetes load-testing locust locust-docker locustfile stress-testing

Last synced: about 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/peter-evans/locust-docker
Owner: peter-evans
License: mit
Created: 2016-12-21T09:10:19.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2022-01-28T03:38:13.000Z (almost 3 years ago)
Last Synced: 2024-10-30T04:17:52.705Z (2 months ago)
Topics: docker-image, kubernetes, load-testing, locust, locust-docker, locustfile, stress-testing
Language: Shell
Homepage: https://hub.docker.com/r/peterevans/locust/
Size: 90.8 KB
Stars: 20
Watchers: 4
Forks: 11
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        # Locust Docker

[![](https://images.microbadger.com/badges/image/peterevans/locust.svg)](https://microbadger.com/images/peterevans/locust)

[![CircleCI](https://circleci.com/gh/peter-evans/locust-docker/tree/master.svg?style=svg)](https://circleci.com/gh/peter-evans/locust-docker/tree/master)

Docker image for the [Locust](http://locust.io/) 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*)](https://github.com/peter-evans/locust-docker/tree/v1.6.4)

- [`1.6.3`, `1.6.3-locustio0.14.5`, `1.6-locustio0.14.5`, `latest-locustio0.14.5`  (*1.6/Dockerfile*)](https://github.com/peter-evans/locust-docker/tree/v1.6.3)

- [`1.6.2`, `1.6.2-locustio0.14.4`, `1.6-locustio0.14.4`, `latest-locustio0.14.4`  (*1.6/Dockerfile*)](https://github.com/peter-evans/locust-docker/tree/v1.6.2)

- [`1.6.1`  (*1.6/Dockerfile*)](https://github.com/peter-evans/locust-docker/tree/v1.6.1)

## Usage

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

```bash

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/](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`.

	```bash

	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.

	```bash

    kubectl create -f ./locust-master.yaml

    kubectl create -f ./locust-slave.yaml

    ```

## License

MIT License - see the [LICENSE](LICENSE) file for details