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 -----------------------------------------------------------
70 drivers/gpu/drm/ci/${DRIVER_NAME}-${HW_REVISION}-skips.txt
71 -----------------------------------------------------------
81 1. Create a Linux tree in https://gitlab.freedesktop.org/ if you don't have one
85 https://gitlab.freedesktop.org/janedoe/linux/-/settings/ci_cd), change the
86 CI/CD configuration file from .gitlab-ci.yml to
87 drivers/gpu/drm/ci/gitlab-ci.yml.
89 3. Next time you push to this repository, you will see a CI pipeline being
90 created (eg. https://gitlab.freedesktop.org/janedoe/linux/-/pipelines)
101 drivers/gpu/drm/ci/${DRIVER_NAME}_*_fails.txt, for each of the test platforms
114 gitlab-ci.yml file.
120 For testing changes to the scripts in the drm-ci repo, change the
122 drivers/gpu/drm/ci/gitlab-ci.yml to match your fork of the project (eg.
123 janedoe/drm-ci). This fork needs to be in https://gitlab.freedesktop.org/.
132 ${TARGET_BRANCH}-external-fixes.
144 https://gitlab.freedesktop.org/gfx-ci/lab-status/-/blob/main/lab-status.yml.