/rhel-edge

RHEL for Edge Downstream CI and Test

Primary LanguageShellMIT LicenseMIT

RHEL-Edge

RHEL-Edge help documentation

RHEL-Edge Test Scope

RHEL for Edge test from QE is more like an integration test. The test flow aligns with the customer scenario. The whole test includes three parts:

  1. RHEL for Edge image building with osbuild-composer

    • Build RHEL 8 and RHEL 9 x86_64 images at OpenStack VM
    • Build CentOS Stream 8 and CentOS Stream 9 x86_64 images at Google Cloud VM

  2. RHEL for Edge image installation

    • edge-commit: Setup HTTP server to serve as ostree repo, and install with kickstart
    • edge-container: Setup prod ostree repo, edge-container as stage repo, and install with kickstart from prod ostree repo
    • edge-installer: Install from edge-installer ISO
    • edge-raw-image: Boot from raw image with KVM
    • edge-simplified-installer: Install from edge-simplified-installer ISO

  3. RHEL for Edge system upgrade

    • Upgrade with the same OSTree ref
    • Upgrade to a new OSTree ref
    • Upgrade from RHEL 8 to RHEL 9 or from CentOS Stream 8 to CentOS Stream 9

  4. Checkings after installation/upgrade.

    • Check installed ostree commit
    • Check mount point
    • Check greenboot services
    • Run container with podman (root and non-root)
    • Check auto rollback with greenboot when failure is detected

RHEL-Edge CI

Upstream CI

For RHEL-Edge project, 90% of features come from osbuild and osbuild-composer. In this case, osbuild and osbuild-composer CI will be used ad RHEL-Edge project upstream CI.

The Upstream CI is triggered by each PR and it focuses on code change.

Considering Upstream CI environment and test duration, the Upstream CI only covers virtualization tests, bare metal is out of Upstream CI scope.

Downstream CI

RHEL 8, RHEL 9, CentOS Stream 8 and CentOS Stream 9 report dashboard

Fedora rawhide report dashboard

CI for this repository

CI for this repository is to test test code. It's triggered by PR in this repository. Any changes for test code has to be pass all tests of CI before they are merged into master.

Test of this CI includes:

  1. Shellcheck: running on Github
  2. Yaml lint: running on Github
  3. Edge tests: running on Github

RHEL-Edge CI details can be found from CI doc

RHEL-Edge Test

Test Scenario

Test suites in scenario:

  1. ostree.sh: edge-commit/fedora-iot-commit(tar) image type test on RHEL 8.x, RHEL 9.x, CentOS Stream 8, CentOS Stream 9, and Fedora
  2. ostree-ng.sh: edge-container and edge-installer(ISO) image types test on RHEL 8.x, RHEL 9.x, CentOS Stream 8, and CentOS Stream 9
  3. ostree-raw-image.sh: edge-raw-image(raw) image types test on RHEL 8.x, RHEL 9.x, CentOS Stream 8, and CentOS Stream 9
  4. ostree-simplified-installer.sh: edge-simplified-installer(ISO) image types test on RHEL 8.x, RHEL 9.x, CentOS Stream 8, and CentOS Stream 9
  5. ostree-rebase.sh: Different ostree ref rebase test on RHEL 8.x and CentOS Stream 8
  6. ostree-8-to-9.sh: RHEL 8/CentOS Stream 8 Edge system upgrade to RHEL 9/CentOS Stream 9 Edge system test

Test environment

You can run RHEL for Edge test on any x86_64 machine, like server, laptop, or VM, but KVM has to be enabled. Otherwise QEMU will be used and the test will take a really long time.

$ls -l /dev/kvm

Supported OS

RHEL 8.6/8.7
RHEL 9.0/9.1
CentOS Stream 8
CentOS Stream 9
Fedora 36 (For `ostree.sh` only)
Fedora 37 (For `ostree.sh` only)

Test Run

$ ./ostree.sh
$ OCP4_TOKEN=abcdefg QUAY_USERNAME=rhel-edge QUAY_PASSWORD=123456 ./ostree-ng.sh
$ DOCKERHUB_USERNAME=rhel-edge DOCKERHUB_PASSWORD=123456 ./ostree-raw-image.sh
$ ./ostree-simplified-installer.sh
$ ./ostree-rebase.sh
$ ./ostree-8-to-9.sh

Test Configuration

You can set these environment variables to run test

QUAY_USERNAME      quay.io username
                       Used to test pushing Edge OCI-archive image to quay.io
QUAY_PASSWORD      quay.io password
                       Used to test pushing Edge OCI-archive image to quay.io
DOCKERHUB_USERNAME      Docker hub account username
                       Used to test pushing Edge OCI-archive image to Docker hub
DOCKERHUB_PASSWORD      Docker hub account password
                       Used to test pushing Edge OCI-archive image to Docker hub
OCP4_TOKEN         Edit-able SA token on PSI Openshift 4
                       Deploy edge-container on PSI OCP4

Contact us