mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-09-09 01:04:59 +00:00
60 lines
2.4 KiB
ReStructuredText
60 lines
2.4 KiB
ReStructuredText
|
==============
|
||
|
CI for libvirt
|
||
|
==============
|
||
|
|
||
|
This document provides some information related to the CI capabilities for the
|
||
|
libvirt project.
|
||
|
|
||
|
|
||
|
Cirrus CI integration
|
||
|
=====================
|
||
|
|
||
|
libvirt currently supports three non-Linux operating systems: Windows, FreeBSD
|
||
|
and macOS. Windows cross-builds can be prepared on Linux by using `MinGW`_, but
|
||
|
for both FreeBSD and macOS we need to use the actual operating system, and
|
||
|
unfortunately GitLab shared runners are currently not available for either.
|
||
|
|
||
|
To work around this limitation, we take advantage of `Cirrus CI`_'s free
|
||
|
offering: more specifically, we use the `cirrus-run`_ script to trigger Cirrus
|
||
|
CI jobs from GitLab CI jobs so that the workaround is almost entirely
|
||
|
transparent to users and there's no need to constantly check two separate CI
|
||
|
dashboards.
|
||
|
|
||
|
There is, however, some one-time setup required. If you want FreeBSD and macOS
|
||
|
builds to happen when you push to your GitLab repository, you need to
|
||
|
|
||
|
* set up a GitHub repository for the project, eg. ``yourusername/libvirt``.
|
||
|
This repository needs to exist for cirrus-run to work, but it doesn't need to
|
||
|
be kept up to date, so you can create it and then forget about it;
|
||
|
|
||
|
* enable the `Cirrus CI GitHub app`_ for your GitHub account;
|
||
|
|
||
|
* sign up for Cirrus CI. It's enough to log into the website using your GitHub
|
||
|
account;
|
||
|
|
||
|
* grab an API token from the `Cirrus CI settings`_ page;
|
||
|
|
||
|
* in the *CI/CD / Variables* section of the settings page for your GitLab
|
||
|
repository, create two new variables:
|
||
|
|
||
|
* ``CIRRUS_GITHUB_REPO``, containing the name of the GitHub repository
|
||
|
created earlier, eg. ``yourusername/libvirt``;
|
||
|
|
||
|
* ``CIRRUS_API_TOKEN``, containing the Cirrus CI API token generated earlier.
|
||
|
This variable **must** be marked as *Masked*, because anyone with knowledge
|
||
|
of it can impersonate you as far as Cirrus CI is concerned.
|
||
|
|
||
|
Neither of these variables should be marked as *Protected*, because in
|
||
|
general you'll want to be able to trigger Cirrus CI builds from non-protected
|
||
|
branches.
|
||
|
|
||
|
Once this one-time setup is complete, you can just keep pushing to your GitLab
|
||
|
repository as usual and you'll automatically get the additional CI coverage.
|
||
|
|
||
|
|
||
|
.. _Cirrus CI GitHub app: https://github.com/marketplace/cirrus-ci
|
||
|
.. _Cirrus CI settings: https://cirrus-ci.com/settings/profile/
|
||
|
.. _Cirrus CI: https://cirrus-ci.com/
|
||
|
.. _MinGW: http://mingw.org/
|
||
|
.. _cirrus-run: https://github.com/sio/cirrus-run/
|