From 294b5a982104507add92a1117acbba3c3c6677c3 Mon Sep 17 00:00:00 2001 From: Erik Skultety Date: Tue, 12 Jul 2022 13:19:14 +0200 Subject: [PATCH] docs: ci: Add info about the two major types of jobs our CI runs MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Erik Skultety Reviewed-by: Daniel P. Berrangé --- docs/ci.rst | 39 ++++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 19 deletions(-) diff --git a/docs/ci.rst b/docs/ci.rst index d5282c4d25..566bc42db7 100644 --- a/docs/ci.rst +++ b/docs/ci.rst @@ -8,6 +8,9 @@ The libvirt project uses GitLab CI for automated testing. `Here's `__ our CI dashboard which shows the current status of our pipelines. +Builds and unit tests +===================== + Linux builds and cross-compiled Windows builds happen on GitLab CI's shared runners, while FreeBSD and macOS coverage is achieved by triggering `Cirrus CI `_ jobs behind the scenes. @@ -15,27 +18,25 @@ runners, while FreeBSD and macOS coverage is achieved by triggering `Cirrus CI Most of the tooling used to build CI pipelines is maintained as part of the `libvirt-ci `_ subproject. +Integration tests +================= +Integration tests in our CI pipelines require dedicated HW which is not +available to forks, see `GitLab CI Custom Runners `__. +Therefore, in order to execute the integration tests as part of your libvirt +fork's GitLab CI you'll need to provide your own runner. You'll also need to +set a few CI variables to run the integration tests as part of the CI pipeline, +see below. +GitLab CI variables +------------------- +* ``LIBVIRT_CI_INTEGRATION`` - enables integration test runs manually or in forks +* ``LIBVIRT_CI_INTEGRATION_RUNNER_TAG`` - overrides the upstream runner tag on the +Retrieving test logs +-------------------- - - - - - - - - - - - - - - - - - - - +In case the integration test suite fails in our CI pipelines, a job artifact is +generated containing Avocado logs, libvirt debug logs, and the latest traceback +(if one was produced during a daemon's execution). -- 2.47.2