Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sernst/locusts
Locust.io docker container for Python 3.8+
https://github.com/sernst/locusts
docker load-testing locusts-docker-image python python-3 swarm
Last synced: 2 months ago
JSON representation
Locust.io docker container for Python 3.8+
- Host: GitHub
- URL: https://github.com/sernst/locusts
- Owner: sernst
- Created: 2017-05-29T13:17:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-12-08T16:00:10.000Z (about 4 years ago)
- Last Synced: 2024-04-12T16:09:16.895Z (9 months ago)
- Topics: docker, load-testing, locusts-docker-image, python, python-3, swarm
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 26
- Watchers: 0
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Locusts Docker Image
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Code style: flake8](https://img.shields.io/badge/code%20style-flake8-white)](https://gitlab.com/pycqa/flake8)
[![Code style: mypy](https://img.shields.io/badge/code%20style-mypy-white)](http://mypy-lang.org/)The locusts docker image is designed for easily composing multi-container
[locust.io](http://http://locust.io/)
load testing swarms using Python 3.8+. The locusts image functions can function
as either a main or worker depending on whether or not the `--master-host`
flag is specified in a container's run execution call.The docker image is available in
[Docker Hub](https://hub.docker.com/r/swernst/locusts/). You can pull the
image with the command:```bash
$ docker pull swernst/locusts:latest
```## Main & Workers
The optional `--main-host` argument is used to specify that the container
should be a worker and communicate with the main with the specified host.
For example:```bash
$ docker run -it --rm \
-v ./scripts:/scripts \
swernst/locusts \
--main-host=127.0.0.1
```would specify a worker container where the main resides at the local
`127.0.0.1` host location.## Script Volume
A locusts container requires that a volume be mounted to the container's
`/scripts` directory. It expects to find the *locustfile.py* to run in that
directory as well as a *locust.config.yaml* file.Alternatively, this image can be used as a base image and the files copied
into the scripts directory of the built container image.## Docker Compose
The multi-container environment is easily specified using docker compose. You
can see an example in this repository of how that would look:
[docker-compose.yml](docker-compose.yml)