On Tue, Jul 12, 2022 at 02:44:40PM +0200, Erik Skultety wrote: > Signed-off-by: Erik Skultety <eskultet@xxxxxxxxxx> > --- > docs/ci.rst | 20 ++++++++++++++++++++ > 1 file changed, 20 insertions(+) > > diff --git a/docs/ci.rst b/docs/ci.rst > index d5282c4d25..bef023c521 100644 > --- a/docs/ci.rst > +++ b/docs/ci.rst > @@ -8,6 +8,9 @@ The libvirt project uses GitLab CI for automated testing. > `Here's <ci-dashboard.html>`__ our CI dashboard which shows the current status > of our pipelines. > > +Libvirt builds > +============== THis section talks about FreeBSD/macOS via Cirrus CI too. Perhaps call it 'Build 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 > <https://cirrus-ci.com/>`_ jobs behind the scenes. > @@ -15,11 +18,28 @@ 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 <https://gitlab.com/libvirt/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 <ci-runners.html>`__. > +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.36.1 > With regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
