Documentation/gpu/automated_testing.rst

1 .. SPDX-License-Identifier: GPL-2.0+
11 be very time-consuming when lots of different hardware configurations need to
20 There are facilities in gitlab.freedesktop.org to automatically test Mesa that
29 drivers/gpu/drm/ci/gitlab-ci.yml
30 --------------------------------
32 This is the root configuration file for GitLab CI. Among other less interesting
37     Repository that contains the Mesa software infrastructure for CI
49     Revision of igt-gpu-tools being used, from
50     https://gitlab.freedesktop.org/drm/igt-gpu-tools
52 drivers/gpu/drm/ci/testlist.txt
53 -------------------------------
55 IGT tests to be run on all drivers (unless mentioned in a driver's \*-skips.txt
58 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-fails.txt
59 ----------------------------------------------------------
63 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-flakes.txt
64 -----------------------------------------------------------
78   # Board Name: broken-board.dtb
79   # Linux Version: 6.6-rc1
80   # IGT Version: 1.28-gd2af13d9f
82   flaky-test
84 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-skips.txt
85 -----------------------------------------------------------
95 1. Create a Linux tree in https://gitlab.freedesktop.org/ if you don't have one
99 https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd), change the
100 CI/CD configuration file from .gitlab-ci.yml to
101 drivers/gpu/drm/ci/gitlab-ci.yml.
103 3. Request to be added to the drm/ci-ok group so that your user has the
104 necessary privileges to run the CI on https://gitlab.freedesktop.org/drm/ci-ok
106 4. Next time you push to this repository, you will see a CI pipeline being
107 created (eg. https://gitlab.freedesktop.org/janedoe/linux/-/pipelines)
118 drivers/gpu/drm/ci/${DRIVER_NAME}_*_fails.txt, for each of the test platforms
131 gitlab-ci.yml file.
137 For testing changes to the scripts in the drm-ci repo, change the
139 drivers/gpu/drm/ci/gitlab-ci.yml to match your fork of the project (eg.
140 janedoe/drm-ci). This fork needs to be in https://gitlab.freedesktop.org/.
149 ${TARGET_BRANCH}-external-fixes.
161 https://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml.