docs/devel/ci-jobs.rst.inc

   1 Custom CI/CD variables
   2 ======================
   3
   4 QEMU CI pipelines can be tuned by setting some CI environment variables.
   5
   6 Set variable globally in the user's CI namespace
   7 ------------------------------------------------
   8
   9 Variables can be set globally in the user's CI namespace setting.
  10
  11 For 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
  15 Set variable manually when pushing a branch or tag to the user's repository
  16 ---------------------------------------------------------------------------
  17
  18 Variables can be set manually when pushing a branch or tag, using
  19 git-push command line arguments.
  20
  21 Example 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
  27 For 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
  31 Here is a list of the most used variables:
  32
  33 QEMU_CI_AVOCADO_TESTING
  34 ~~~~~~~~~~~~~~~~~~~~~~~
  35 By default, tests using the Avocado framework are not run automatically in
  36 the pipelines (because multiple artifacts have to be downloaded, and if
  37 these artifacts are not already cached, downloading them make the jobs
  38 reach the timeout limit). Set this variable to have the tests using the
  39 Avocado framework run automatically.
  40
  41 AARCH64_RUNNER_AVAILABLE
  42 ~~~~~~~~~~~~~~~~~~~~~~~~
  43 If you've got access to an aarch64 host that can be used as a gitlab-CI
  44 runner, you can set this variable to enable the tests that require this
  45 kind of host. The runner should be tagged with "aarch64".
  46
  47 S390X_RUNNER_AVAILABLE
  48 ~~~~~~~~~~~~~~~~~~~~~~
  49 If you've got access to an IBM Z host that can be used as a gitlab-CI
  50 runner, you can set this variable to enable the tests that require this
  51 kind of host. The runner should be tagged with "s390x".