Skip to content
This repository has been archived by the owner on Feb 4, 2024. It is now read-only.

Bootstraps a Lima instance with the selected Linux kernel version for building and testing kernel modules.

License

Notifications You must be signed in to change notification settings

antoineco/kernel-devel-vm-action

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kernel Devel VM Action

A GitHub Action that bootstraps a Lima instance running Fedora Linux with the selected kernel version.

Its main purpose is to facilitate the building and testing of kernel modules in CI workflows. It was originally written to support the automated build pipeline for the broadcom-wl wireless driver.

How It Works

The Action queries Fedora's public mirrors to retrieve the latest QEMU image and SHA256 checksum for the selected OS version, and generates a Lima instance configuration using this information.

It then mounts provisioning scripts inside that instance, which Lima executes as part of its initialization process (cloud-init). The scripts query Bodhi — Fedora's updates system — to find and download the most suitable kernel candidate for the selected version. If a candidate is found, it is installed and the bootloader configuration gets updated to boot on that specific kernel version.

Usage

Pre-requisites

  • A runner with Virtualization enabled, to support QEMU/KVM
  • Lima ≥ 0.12.x
  • yq ≥ 4.x

Inputs

  • kernel (required): The desired kernel version in <major>.<minor> semantic format (e.g. "5.19").
  • os: The version code of the Fedora Linux release to bootstrap the instance with (e.g. "f38"). Defaults to f39.

Outputs

  • kernel: The full version string of the kernel running inside the bootstrapped instance (e.g. "5.19.17-300.fc37.x86_64").
  • kernel-short: The short, SemVer compatible version string of the kernel running inside the bootstrapped instance (e.g. "5.19.17").
  • logs: Location on the runner of the exported cloud-init logs (e.g. "/tmp/lima/myinstance").

Environment variables

Upon execution, this Action sets the LIMA_INSTANCE environment variable to the name of the bootstrapped Lima instance, and makes it available to all subsequent job steps.

Example workflow

name: Build Kernel Module

on: push

jobs:
  build:
    runs-on: ubuntu-latest

    strategy:
      matrix:
        include:
        - kernel: '6.3'
          os: f37
        - kernel: '6.4'
          os: f38
        - kernel: '6.5'
          os: f39

    steps:
    - name: Bootstrap Lima instance
      id: builder
      uses: antoineco/kernel-devel-vm-action@v1
      with:
        kernel: ${{ matrix.kernel }}
        os: ${{ matrix.os }}

    - name: Build kernel module
      id: build
      run: lima make

For more elaborate usage examples, take a look at the build workflow for broadcom-wl, or the CI workflow for this Action.

About

Bootstraps a Lima instance with the selected Linux kernel version for building and testing kernel modules.

Topics

Resources

License

Stars

Watchers

Forks

Languages