xref: /openbmc/qemu/docs/devel/ci-jobs.rst.inc (revision 096b778f)
1Custom CI/CD variables
2======================
3
4QEMU CI pipelines can be tuned by setting some CI environment variables.
5
6Set variable globally in the user's CI namespace
7------------------------------------------------
8
9Variables can be set globally in the user's CI namespace setting.
10
11For further information about how to set these variables, please refer to::
12
13  https://docs.gitlab.com/ee/ci/variables/#add-a-cicd-variable-to-a-project
14
15Set variable manually when pushing a branch or tag to the user's repository
16---------------------------------------------------------------------------
17
18Variables can be set manually when pushing a branch or tag, using
19git-push command line arguments.
20
21Example setting the QEMU_CI_EXAMPLE_VAR variable:
22
23.. code::
24
25   git push -o ci.variable="QEMU_CI_EXAMPLE_VAR=value" myrepo mybranch
26
27For further information about how to set these variables, please refer to::
28
29  https://docs.gitlab.com/ee/user/project/push_options.html#push-options-for-gitlab-cicd
30
31Here is a list of the most used variables:
32
33QEMU_CI_AVOCADO_TESTING
34~~~~~~~~~~~~~~~~~~~~~~~
35By default, tests using the Avocado framework are not run automatically in
36the pipelines (because multiple artifacts have to be downloaded, and if
37these artifacts are not already cached, downloading them make the jobs
38reach the timeout limit). Set this variable to have the tests using the
39Avocado framework run automatically.
40
41AARCH64_RUNNER_AVAILABLE
42~~~~~~~~~~~~~~~~~~~~~~~~
43If you've got access to an aarch64 host that can be used as a gitlab-CI
44runner, you can set this variable to enable the tests that require this
45kind of host. The runner should be tagged with "aarch64".
46
47AARCH32_RUNNER_AVAILABLE
48~~~~~~~~~~~~~~~~~~~~~~~~
49If you've got access to an armhf host or an arch64 host that can run
50aarch32 EL0 code to be used as a gitlab-CI runner, you can set this
51variable to enable the tests that require this kind of host. The
52runner should be tagged with "aarch32".
53
54S390X_RUNNER_AVAILABLE
55~~~~~~~~~~~~~~~~~~~~~~
56If you've got access to an IBM Z host that can be used as a gitlab-CI
57runner, you can set this variable to enable the tests that require this
58kind of host. The runner should be tagged with "s390x".
59
60CENTOS_STREAM_8_x86_64_RUNNER_AVAILABLE
61~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
62If you've got access to a CentOS Stream 8 x86_64 host that can be
63used as a gitlab-CI runner, you can set this variable to enable the
64tests that require this kind of host. The runner should be tagged with
65both "centos_stream_8" and "x86_64".
66