diff options
| author | Philippe Mathieu-Daudé <philmd@redhat.com> | 2021-07-27 16:24:28 +0200 |
|---|---|---|
| committer | Thomas Huth <thuth@redhat.com> | 2021-07-29 07:56:01 +0200 |
| commit | 9ada9fd2593716cc1c61f2d56bb84bef12056cb1 (patch) | |
| tree | 65ddead5df8c3ec45378886cf7f11fcf6057a10b /docs/devel/ci.rst | |
| parent | 69ea12b19a15ae006521cd5cc0f627f27f738746 (diff) | |
| download | qemu-9ada9fd2593716cc1c61f2d56bb84bef12056cb1.zip qemu-9ada9fd2593716cc1c61f2d56bb84bef12056cb1.tar.gz qemu-9ada9fd2593716cc1c61f2d56bb84bef12056cb1.tar.bz2 | |
docs: Document GitLab custom CI/CD variables
We introduced the QEMU_CI_AVOCADO_TESTING variable in commit f56bf4caf
("gitlab: Run Avocado tests manually (except mainstream CI)"), but
forgot to document it properly. Do it now.
Suggested-by: Thomas Huth <thuth@redhat.com>
Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Reviewed-by: Willian Rampazzo <willianr@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Message-Id: <20210727142431.1672530-2-philmd@redhat.com>
Signed-off-by: Thomas Huth <thuth@redhat.com>
Diffstat (limited to 'docs/devel/ci.rst')
| -rw-r--r-- | docs/devel/ci.rst | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/devel/ci.rst b/docs/devel/ci.rst index b3bf3ef..2055725 100644 --- a/docs/devel/ci.rst +++ b/docs/devel/ci.rst @@ -8,6 +8,46 @@ found at:: https://wiki.qemu.org/Testing/CI +Custom CI/CD variables +====================== + +QEMU CI pipelines can be tuned by setting some CI environment variables. + +Set variable globally in the user's CI namespace +------------------------------------------------ + +Variables can be set globally in the user's CI namespace setting. + +For further information about how to set these variables, please refer to:: + + https://docs.gitlab.com/ee/ci/variables/#add-a-cicd-variable-to-a-project + +Set variable manually when pushing a branch or tag to the user's repository +--------------------------------------------------------------------------- + +Variables can be set manually when pushing a branch or tag, using +git-push command line arguments. + +Example setting the QEMU_CI_EXAMPLE_VAR variable: + +.. code:: + + git push -o ci.variable="QEMU_CI_EXAMPLE_VAR=value" myrepo mybranch + +For further information about how to set these variables, please refer to:: + + https://docs.gitlab.com/ee/user/project/push_options.html#push-options-for-gitlab-cicd + +Here is a list of the most used variables: + +QEMU_CI_AVOCADO_TESTING +~~~~~~~~~~~~~~~~~~~~~~~ +By default, tests using the Avocado framework are not run automatically in +the pipelines (because multiple artifacts have to be downloaded, and if +these artifacts are not already cached, downloading them make the jobs +reach the timeout limit). Set this variable to have the tests using the +Avocado framework run automatically. + Jobs on Custom Runners ====================== |