devel/testing/ci-runners.rst.inc

11 be set up with GitLab's "agent", called gitlab-runner, which will take
14 gitlab-runner, is called a "custom runner".
18   .gitlab-ci.d/custom-runners.yml
21 currently deployed in the QEMU GitLab CI and their maintainers, please
22 refer to the QEMU `wiki <https://wiki.qemu.org/AdminContacts>`__.
24 Machine Setup Howto
25 -------------------
27 For all Linux based systems, the setup can be mostly automated by the
29 under ``scripts/ci/setup``, such as this::
44 The ``scripts/ci/setup/$DISTRO/build-environment.yml`` Ansible
46 builds and run QEMU tests. This playbook consists on the installation
54   cd scripts/ci/setup
55   ansible-playbook -i inventory $DISTRO/build-environment.yml
59 by ``sudo``.  If necessary, please refer to ``ansible-playbook``
60 options such as ``--become``, ``--become-method``, ``--become-user``
61 and ``--ask-become-pass``.
63 gitlab-runner setup and registration
66 The gitlab-runner agent needs to be installed on each machine that
71  * Settings (the gears-like icon at the bottom of the left hand side
78 Copy the ``scripts/ci/setup/vars.yml.template`` file to
79 ``scripts/ci/setup/vars.yml``.  Then, set the
85   cd scripts/ci/setup
86   ansible-playbook -i inventory gitlab-runner.yml
105 Because the job definition at ``.gitlab-ci.d/custom-runners.yml``
108   ubuntu-20.04-aarch64-all:
110    - ubuntu_20.04
111    - aarch64