Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Pravoru/gatling-remote-sbt
Remote execution plugin for gatling load tests.
https://github.com/Pravoru/gatling-remote-sbt
gatling load-testing remote-execution sbt-plugin
Last synced: about 1 month ago
JSON representation
Remote execution plugin for gatling load tests.
- Host: GitHub
- URL: https://github.com/Pravoru/gatling-remote-sbt
- Owner: Pravoru
- License: mit
- Created: 2017-07-20T09:47:53.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-29T07:35:57.000Z (over 4 years ago)
- Last Synced: 2024-01-25T05:40:45.473Z (11 months ago)
- Topics: gatling, load-testing, remote-execution, sbt-plugin
- Language: Scala
- Homepage:
- Size: 60.5 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: License.md
Awesome Lists containing this project
- awesome-gatling - gatling-remote-sbt - Remote execution plugin for Gatling load tests. (Tools / Plugins)
README
# Gatling remote sbt plugin
## Goal
Gatling is excellent load test framework, but is has some limitations. The biggest limitation is absence of remote execution.
This plugin brings ability to run simulation remotely through ssh.
## Dependencies
* [gatling-sbt](https://github.com/gatling/gatling-sbt)
* [sbt-native-packager](https://github.com/sbt/sbt-native-packager)
* [sshj](https://github.com/hierynomus/sshj)
## Installation
We mimic gatling-sbt versioning. For our purposes we use fourth digit in version number.
`plugins.sbt`
```scala
addSbtPlugin("ru.pravo" %% "gatling-remote-sbt" % "3.0.0.1")
addSbtPlugin("com.typesafe.sbt" %% "sbt-native-packager" % "1.3.6")
addSbtPlugin("io.gatling" %% "gatling-sbt" % "3.0.0")
```
`build.sbt`
```scala
enablePlugins(GatlingPlugin, JavaAppPackaging, GatlingRemotePlugin)
```
`gatling-remote.conf`
```
hosts = [
{
host = "localhost",
login = "root",
password = "root",
port = 2222
}
]
```
## Configuration
There are multiple setting for configuration:
Setting | Description | Default
------- | ----------- | -------
|`gatlingConfigFilePath`|Path to `gatling.conf` file|`src/test/resources/gatling.conf`|
|`gatlingAkkaConfigFilePath`|Path to `gatling-akka.conf` file|`src/test/resources/gatling-akka.conf`|
|`gatlingRemoteConfigFilePath`|Path to `gatling-remote.conf` file|`src/test/resources/gatling-remote.conf`|
|`logbackConfigFilePath`|Path to `logback.xml` file|`src/test/resources/logback.xml`|
|`remoteWorkDirectoryPath`|Path to work directory on remote server|`/tmp`|
|`deployTimeoutDuration`|Timeout for deploying operation|`Infinite`|
|`runTimeoutDuration`|Timeout for running operation|`Infinite`|
|`grafiteRootPathPrefix`|Root path that will be overwritten in run.sh|`gatling`|
|`configurationFiles`|Configuration files that will be deployed into /conf directory|`Seq(gatling.conf, gatling-akka.conf, gatling-remote.conf, logback.xml)`|
|`userFilesDataFiles`|User files that will be deployed into /user-files/body directory|`Seq()`|
You can override any of these settings. For example
```scala
gatlingConfigFilePath in Gatling := (resourceDirectory in Compile).value / "gatling.conf"
```
will force plugin to take `gatling.conf` from `/src/resources/gatling.conf`
## Using
Run simulation
```bash
sbt gatling:testOnlyRemote basic.BasicExampleSimulationFails
```
Get assembled project
```bash
sbt gatling:assembleProject
```