Docker

Here is the official Testerum Runner docker image.
This image can be used to easily run Testerum tests in a CI/CD environment.

Prerequisite

You don't need to install any plugins to run the docker image.

How to use this image

This image can be used to execute the Testerum tests.

To give the Testerum Runner access to your tests, you need to mount a bind volume containing your tests, and optionally, a volume where the test reports will be placed.

To make it easy to run Selenium Webdriver tests, this image also includes Firefox and Chrome, which can run in headless mode.

Command line example:

    docker run --rm \
    --volume /path/to/testerum/tests-project-directory:/tests \
    testerum/testerum:latest

To see what command-line arguments are accepted by the Testerum Runner, use --help:

    docker run --rm \
    --volume /path/to/testerum/tests-project-directory:/tests \
    testerum/testerum:latest \
    --help

You should not pass the --repository-directory and --managed-reports-directory arguments, since these are already included (and point to /tests and /reports directories inside the docker container).

More information about the command-line arguments can be found on the Testerum Runner documentation page.

Local Reports

If you want the test reports to be written as files, you need to mount a directory where the reports will be written:

    docker run --rm \
    --volume /path/to/testerum/tests-project-directory:/tests \
    --volume /path/to/where/the-reports-will-be-written:/reports \
    testerum/testerum:latest

Note on the user mapping in Linux:

This image will create files on the host computer, inside the mapped reports directory. These files will be owned by the user and the group with id 1000.
In the majority of cases, this is the first non-root user, so everything will have the same permissions as the user that regularly uses that computer/laptop.
If you customized your user ID or have a different setup, you may have to change the owner of the reports directory, before you will be able to use the reports:

sudo chown myuser: -R /path/to/where/the-reports-will-be-written

This only applies to Linux, and shouldn't cause any issues on Windows or Mac.

Reports Server

This Docker image can send the reports to the Testerum Reports Server.
This way you don't need to have a persistent volume on your CI/CD environment and you can find all your reports in a single place.
More details about the Testerum Reports Server can be found here.

Instead of mounting a directory where the reports will be written, you need to specify the URL where it is the Reports Server.
Command line example:

    docker run --rm \
    --volume /path/to/testerum/tests-project-directory:/tests \
    --report REMOTE_SERVER:reportServerUrl=https://localhost:7788 \
    testerum/testerum:latest