README.md 1.14 KB
Newer Older
Johan Helsing's avatar
Johan Helsing committed
1
# Docker container for running Qt auto-tests
Johan Helsing's avatar
Johan Helsing committed
2 3 4 5 6 7 8

This container uses a headless Weston server and llvmpipe to run Qts auto tests
with OpenGL and Wayland without requiring a display (i.e. it can run on a
server)

## Usage

Johan Helsing's avatar
Johan Helsing committed
9 10 11 12
Usage is very simple, like almost any other docker image

Build:

Johan Helsing's avatar
Johan Helsing committed
13
    $ docker build -t docker-qt-tests .
Johan Helsing's avatar
Johan Helsing committed
14 15 16

Run:

17 18 19 20 21
    $ docker run -e QT_DOCKERTEST_QTWAYLAND_REV=<sha1> -e QT_DOCKERTEST_QT5_REV=<sha1> -it docker-qt-tests

I.e. to run tests on the 5.11 branch:

    $ docker run -e QT_DOCKERTEST_QTWAYLAND_REV=5.11 -e QT_DOCKERTEST_QT5_REV=5.11 -it docker-qt-tests
22 23 24 25 26

You can also test changes on codereview.qt-project.org by copying the `refs/xx/changes/xxxxxx/x` part from the download of a change field. i.e.:

    $ docker run -e QT_DOCKERTEST_QTWAYLAND_REV=refs/changes/26/231726/2 -e QT_DOCKERTEST_QT5_REV=dev -it docker-qt-tests

Johan Helsing's avatar
Johan Helsing committed
27 28 29 30 31 32 33 34
If you want to pass custom options to configure, you can do so by putting them
in a config.opt file and running docker like this:

    $ docker run -v /path/to/custom/config.opt:/etc/qt/config.opt \
          -e QT_DOCKERTEST_QTWAYLAND_REV=dev \
          -e QT_DOCKERTEST_QT5_REV=dev \
          -it docker-qt-tests