| title | description | lead | date | lastmod | weight |
|---|---|---|---|---|---|
Teamcity Plugin |
Learn how to configure the Gatling Enterprise TeamCity plugin and run your simulations. |
Run your Gatling Enterprise simulations from your TeamCity CI. |
2021-03-08 13:50:20 +0100 |
2021-08-16 17:55:36 +0200 |
5020 |
This plugin allows you to start a Gatling Enterprise simulation directly from your TeamCity platform. This plugin links a TeamCity plan with one and only one Gatling Enterprise simulation.
This plugin doesn't create a new Gatling Enterprise simulation, you have to create it manually before.
To download the plugin, you need to get the zip file located at:
https://downloads.gatling.io/releases/frontline-teamcity-plugin/{{< var ciPluginsVersion >}}/frontline-teamcity-plugin-{{< var ciPluginsVersion >}}.zip
You need to be connected as an administrator of your TeamCity application to install it. Go Administration, Plugins List, Upload plugin zip, and choose the downloaded zip file.
{{< img src="upload-plugin.png" alt="Upload plugin" >}}
Once the plugin is uploaded, you need to enable it.
The plugin needs some global configuration. Go Administration, then Gatling Enterprise.
The Address is the address of your Gatling Enterprise, for example: https://cloud.gatling.io.
The [Gatling Enterprise API Token]({{< ref "../../admin/api-tokens" >}}) is needed to authenticate to Gatling Enterprise. The API token needs the All role.
{{< img src="administration.png" alt="" >}}
Add a new build step called Gatling Enterprise Launcher. Choose in the Simulation list the simulation you want to monitor. You need to configure the global properties of the plugin, and create at least a simulation on your Gatling Enterprise to do this step.
{{< img src="configuration.png" alt="Configuration" >}}
You can display the results of the Gatling Enterprise assertions as a JUnit Test.
Add a new build feature called XML report processing. Choose Ant JUnit as report type, and enter in the Monitoring rules input the following line:
gatlingFrontLineJunitResults/*.xml
{{< img src="junit.png" alt="JUnit" >}}
A new Gatling Enterprise simulation will be started every time the job is run. Check the Console Log to check the advancement of the simulation. If the simulation ran successfully, it will look like the following:
{{< img src="log.png" alt="Console Log" >}}
If the Gatling Enterprise deployment fails (ie because of a shortage of available hosts), the plugin will retry 3 times to redeploy the simulation.
When the job run is finished, you will be able to see on the Gatling Enterprise Results tab, the summary of the Gatling Enterprise simulation.
{{< img src="display-results.png" alt="Display results" >}}