Skip to content

Commit

Permalink
more setup
Browse files Browse the repository at this point in the history
  • Loading branch information
soulgalore committed May 29, 2024
1 parent 8e56f3e commit 665ff28
Showing 1 changed file with 42 additions and 0 deletions.
42 changes: 42 additions & 0 deletions testrunner/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,5 +29,47 @@ node ./app.js --config /path/to/config.yaml

Take a copy of the [default configuration](https://github.com/sitespeedio/onlinetest/blob/main/testrunner/config/default.yaml) and adopt it to your own setup.


## How tests are run

You can choose to either run the tests using the sitespeed.io container or install sitespeed.io/dependencies and browsers yourself.

If you choose to use Docker, set `useDocker` to true in the configuration. Then all you need to do is to make sure to have Docker installed on the server.

You can configure which Docker container to use. Normally when you run sitespeed.io you should configure the exact sitespeed.io version like *sitespeedio/sitespeed.io:36.0.0* to know exact which version you are using. However if you want to deploy your testrunner and then let it auto update, you can use *sitespeedio/sitespeed.io:latest* as the tag and then make sure that you once per day update the container `docker pull sitespeedio/sitespeed.io:latest`.

```yaml
docker:
container: "sitespeedio/sitespeed.io:latest"
```
If you do not use Docker you can follow [these instructions](https://www.sitespeed.io/documentation/sitespeed.io/installation/) to install sitespeed.io. If you plan to run Android tests, make sure to install FFMPEG and the Python dependencies needed to get visual metrics.
## Queues
Desktop and emulated mobile tests will work on tests that comes in the queue named `location.name` in your configuration. That means if you setup miltiple servers with the same location.name, they will work on the same queue, meaning take on the same amount of tests as you have runners at the same time.

For Android tests the default setting is one queue per device (device id). That means that you need to choose the exact device and run the test on that device. However there's also a configuration option where you can add the queue name in the configuration. The config is `queue`. That way you can setup multiple Android devices to work on the same queue.

Setting the same queue like this will make both phones take on tests on the same queue.
```yaml
- name: "Android"
type: "android"
browsers: ["chrome", "firefox"]
model: "Moto G5"
deviceId: "ZY322MMFZ1"
useDocker: false
connectivity: ["native"]
queue: "motog5"
- name: "Android"
type: "android"
browsers: ["chrome", "firefox"]
model: "Moto G5"
deviceId: "XY322MMFZ1"
useDocker: false
connectivity: ["native"]
queue: "motog5"
```

## Documentation
I'm working on the documentation and you will find the full documentation at [https://www.sitespeed.io/documentation/onlinetest](https://www.sitespeed.io/documentation/onlinetest) when it's ready.

0 comments on commit 665ff28

Please sign in to comment.