CITemplates

This project provides reusable CI/CD components and legacy templates for jobs across multiple GNOME projects.

[[TOC]]

Components

gnomeos-build-sysext

The sysext component facilitates the creation of system extension images for GNOME OS.

include:
  - component: gitlab.gnome.org/GNOME/citemplates/gnomeos-build-sysext@0.1.0

Input	Default value	Description
job-name	build-sysext	Name for the job
job-stage	build	Stage to run the job
branch	nightly	Branch of GNOME OS to use
extension-contents	$CI_PROJECT_DIR/extension	Path to a directory for the extension contents
meson-options	""	List of options to setup the meson project

gnomeos-test-sysext

This component runs the specified openQA tests in GNOME OS with the system extension enabled.

include:
  - component: gitlab.gnome.org/GNOME/citemplates/gnomeos-test-sysext@0.1.0

Input	Default value	Description
job-name	test-sysext	Name for the job
job-required	build-sysext	Name of the job that built the extension
job-stage	test	Stage to run the job
tests	tests/openqa	Path to the openQA tests directory

Variables

The following variables must set in the project settings:

Variable	Description
OPENQA_API_KEY	API key for openQA
OPENQA_API_SECRET	API secret for openQA

Requirements

In order for the extension to be enabled, the specified tests must include the following in its scenario_definitions.yaml file:

machines:
  qemu_x86_64:
    settings:
      HDD_2: /extension.sysext.raw
      NUMDISKS: '2'
      QEMU_SMBIOS: 'type=11,value=io.systemd.stub.kernel-cmdline-extra=systemd.mount-extra=/dev/vdb:/var/lib/extensions/extension'

Templates

Flatpak

This is a legacy template for building Flatpak bundles. Visit the wiki for more details.