https://github.com/orn0t/teamcity-locustio

Locust.io test runner for JetBrains Teamcity
https://github.com/orn0t/teamcity-locustio

devops jetbrains-teamcity load-testing locust teamcity

Last synced: 28 days ago
JSON representation

Locust.io test runner for JetBrains Teamcity

• Host: GitHub
• URL: https://github.com/orn0t/teamcity-locustio
• Owner: orn0t
• License: apache-2.0
• Created: 2019-11-30T17:45:12.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-06T18:07:00.000Z (almost 2 years ago)
• Last Synced: 2024-08-04T02:07:58.866Z (4 months ago)
• Topics: devops, jetbrains-teamcity, load-testing, locust, teamcity
• Language: Kotlin
• Size: 3.15 MB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-locust - teamcity-locustio - Configurable [Locust test runner plugin](https://plugins.jetbrains.com/plugin/13415-locust-io-test-runner) for JetBrains Teamcity. (Tools / CI/CD)

README

        
# teamcity-locustio 

Configurable [Locust.io][1] test runner plugin for JetBrains Teamcity.

## About the plugin

The purpose of creating this plugin was to integrate [Locust.io][1] performance tests tool with 

TeamCity builds in more user friendly and useful manner. 

Plugin adds a certain kind of statistic reports, results comparison between builds and more. 

## Features

- Configurable build step for running Locust tool

- Locust report parser for using on Build Statistics tab and charts

- Comparing report values with previous build (so you see regression)

- Configurable thresholds for making build success/fail decision 

## Installation and Configuration

1. Download the latest plugin build from available [releases][2]. 

2. Install plugin as described in official [TeamCity documentation][3].

3. Setup [Locust.io][1] tools on your TeamCity  Agent machine.

4. Add a newly available build step to your project Build Configuration:

![Build step configuration](docs/static/build-step.png)

5. Ensure you have proper `locustfile.py` added to your project and run build.

6. Wait for build finishes and you'll be able to se a new Locust section on build overview page:   

![Build overview info](docs/static/build-info.png)

7. Use `Build > Parameters > Reported statistic values` tab to create a Chart with values you want to observe

![Build charts](docs/static/build-charts.png)

## License

Apache 2.0

[1]: https://locust.io

[2]: https://github.com/orn0t/teamcity-locustio/releases

[3]: https://www.jetbrains.com/help/teamcity/installing-additional-plugins.html