likewhatevs/virtme-ng Action
Run CI workloads inside a virtme-ng VM with a specific kernel
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Mar 22, 2026
- License
- GPL 2.0
Pinned Snippet
uses: likewhatevs/vng-action@5a811fcf1325b268b413d023a70c69f7d35f20c6 # v0.4.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| name | Name for the kernel build cache (e.g., my-project-kernel) | yes | — |
| kernel-url | Git repository URL for the kernel source | yes | — |
| kernel-tag | Git tag or branch to checkout (e.g., v6.12, master) | yes | — |
| version | Cache version string, bump to invalidate the cache (e.g., v1, v2) | no | v3 |
| kconfig | Path to a kconfig fragment file (relative to the repo root) | no | "" |
| cpus | Number of CPUs for the VM (default: all host CPUs) | no | "" |
| memory | Memory for the VM, e.g. 4G, 512M (default: 90% of host RAM) | no | "" |
| network | Network mode for the VM, e.g. user (default: none) | no | "" |
| verbose | Enable verbose vng boot output | no | true |
| cc | C compiler for the kernel build (e.g., clang) | no | "" |
| llvm | Use the full LLVM toolchain (CC=clang, LD=ld.lld, AR=llvm-ar, etc.) | no | "" |
| kernel-compile-cache | Use ccache to speed up kernel rebuilds on cache miss (default: true) | no | true |
| vmlinux-h | Generate vmlinux.h from kernel BTF and cache it alongside the kernel (default: true) | no | true |
| deps-timeout | Timeout in seconds for dependency installation (per attempt) | no | 90 |
| deps-retries | Number of retry attempts for dependency installation | no | 3 |
| append | Additional kernel boot parameters passed to vng via --append | no | mitigations=off |
| qemu-opts | Additional QEMU options passed to vng via --qemu-opts | no | -cpu host |
| run-timeout | Timeout in seconds for the VM workload (0 = no timeout) | no | 0 |
| packages | Extra apt packages to install and cache alongside vng dependencies (space-separated) | no | "" |
| install-recommends | Install recommended packages alongside dependencies (default: false) | no | false |
| apt-cache | Cache apt packages between runs (default: false) | no | false |
| workspace-rw | Mount $GITHUB_WORKSPACE read-write in the VM (default: true) | no | true |
| extra-rwdirs | Additional host directories to mount read-write in the VM (space-separated, tilde-expanded) | no | ~/.cargo |
| run | Commands to execute inside the VM | yes | — |
Outputs
| name | description |
|---|---|
| kernel-sha | Short commit SHA (12 chars) of the resolved kernel commit |