Add basic docs.

Add basic docs
This commit is contained in:
Chris Richardson
2020-09-09 19:55:22 -04:00
parent df5db9b98b
commit 13686acc96

32
Readme.md Normal file
View File

@@ -0,0 +1,32 @@
### What is Locust?
[Locust io](https://locust.io/)
It is a load testing framework that allows you to write tests in actual code in your own
choice of language.
#### How do I use Locust in python?
Locust
Python is the only official client for the load tests. You can find the [docs](https://docs.locust.io/en/stable/writing-a-locustfile.html#)
for writing locustfile aka tests. This most basic example of how to write a test and build it for using it with the
[Locust Operator](https://github.pie.apple.com/official-star/repo/tree/main/server/locust-operator).
#### Files
[Example Test](https://github.pie.apple.com/aci/python-locust-example/blob/develop/test_example.py)
This test creates two tasks that are weighted differently so task foo will be called more often.
The tasks will sleep for 1 second and then fire a success or failure.
[Rio Config](https://github.pie.apple.com/aci/python-locust-example/blob/develop/rio.yaml)
This freestyle build will compile the tests and add them to the path the docker build will
use to add it to the container.
[Docker build](https://github.pie.apple.com/aci/python-locust-example/blob/develop/Dockerfile)
This will build a container used for load testing in. The key part of this is the dir path that the
tests are put into. This will be used in the locust operator config
[Example Operator config](https://github.pie.apple.com/official-star/repo/blob/main/lib/go/locust-operator/config/samples/test-python.yaml)
This example config will run this test for 2 minutes.
The testContainer is the container built by the rio container build here.