mirror of
https://github.com/kata-containers/cgroups-rs.git
synced 2026-08-05 02:13:23 +00:00
c2abd0229d
Run the complete test suite in pinned Ubuntu guests so cgroupfs and systemd coverage does not depend on the GitHub runner's hierarchy. Cross-compile static test binaries on the host to keep TCG execution practical. Signed-off-by: Xuewei Niu <niuxuewei.nxw@antgroup.com>
39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# Reproducible cgroup QEMU test environments
|
|
|
|
These scripts boot the same pinned Ubuntu 22.04 guest in explicit cgroup v1
|
|
and cgroup v2 modes. Both the cgroupfs and systemd backends are therefore
|
|
tested against real kernel interfaces without inheriting the GitHub runner's
|
|
cgroup hierarchy, systemd version, mount layout, or delegation policy.
|
|
|
|
The workflow intentionally defaults to QEMU TCG software emulation. GitHub
|
|
documents Android SDK hardware acceleration on Linux runners, but it does not
|
|
promise general-purpose nested virtualization or `/dev/kvm` access.
|
|
|
|
To keep TCG practical, Rust test executables are cross-compiled as static musl
|
|
binaries on the GitHub runner. Only the completed executables run inside the
|
|
guest. `run-tests-in-cgroup-vm.sh` transfers them together with
|
|
`run-test-binaries-in-guest.sh`, which contains the guest-side test ordering
|
|
and failure cleanup.
|
|
|
|
The scripts are named for their responsibilities:
|
|
|
|
| Script | Responsibility |
|
|
| --- | --- |
|
|
| `build-static-test-binaries.sh` | Cross-compile portable Rust test harnesses |
|
|
| `boot-cgroup-test-vm.sh` | Configure, boot, and verify a v1 or v2 QEMU guest |
|
|
| `run-tests-in-cgroup-vm.sh` | Transfer tests and coordinate execution over SSH |
|
|
| `run-test-binaries-in-guest.sh` | Execute test harnesses inside the guest |
|
|
| `stop-cgroup-test-vm.sh` | Stop the disposable QEMU guest |
|
|
|
|
The test matrix runs entirely in QEMU:
|
|
|
|
| Guest mode | Filesystem backend | systemd backend |
|
|
| --- | --- | --- |
|
|
| Ubuntu 22.04, cgroup v1 | cgroup v1 | cgroup v1 |
|
|
| Ubuntu 22.04, cgroup v2 | cgroup v2 | cgroup v2 |
|
|
|
|
Both modes are selected with an explicit
|
|
`systemd.unified_cgroup_hierarchy=<0|1>` kernel argument. Each guest must pass
|
|
an exact hierarchy check before tests start. This is important because several
|
|
existing tests return early when their expected cgroup version is unavailable.
|