diff options
| author | Bruce Ashfield <bruce.ashfield@gmail.com> | 2026-02-25 04:38:28 +0000 |
|---|---|---|
| committer | Bruce Ashfield <bruce.ashfield@gmail.com> | 2026-02-26 01:05:02 +0000 |
| commit | 506d5af230f0b41809dfe754e84d5611b75c6585 (patch) | |
| tree | dfa2cc520f6fe1ecb867c0373d6eb353e89977d4 /recipes-core/vxn | |
| parent | efccccda627426319d4ced3b8c8467962a69e30c (diff) | |
| download | meta-virtualization-506d5af230f0b41809dfe754e84d5611b75c6585.tar.gz | |
xen: update documentation with vxn/containerd integration and runtime tests
README-xen.md:
- Add vxn and containerd integration section describing all execution
paths (containerd, vxn standalone, vdkr/vpdmn, native Docker/Podman)
- Add memory requirements section explaining QB_MEM_VALUE=1024 is
insufficient for vxn/vctr and documenting qemuparams="-m 4096"
- Add runtime tests section with build prerequisites, test commands,
and skip behavior
- Fix x86-64 runqemu command to include qemuparams="-m 4096"
vxn/README.md:
- Add testing section referencing the pytest runtime test suite
Signed-off-by: Bruce Ashfield <bruce.ashfield@gmail.com>
Diffstat (limited to 'recipes-core/vxn')
| -rw-r--r-- | recipes-core/vxn/README.md | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/recipes-core/vxn/README.md b/recipes-core/vxn/README.md index 35802e31..2c0ca0ec 100644 --- a/recipes-core/vxn/README.md +++ b/recipes-core/vxn/README.md | |||
| @@ -139,6 +139,32 @@ VM isolation. | |||
| 139 | - `vctr`/`ctr` (containerd) — CNI is separate and opt-in | 139 | - `vctr`/`ctr` (containerd) — CNI is separate and opt-in |
| 140 | - `vdkr`/`vpdmn` — Handle networking independently via xenbr0 | 140 | - `vdkr`/`vpdmn` — Handle networking independently via xenbr0 |
| 141 | 141 | ||
| 142 | ## Testing | ||
| 143 | |||
| 144 | Automated runtime tests boot xen-image-minimal and verify vxn end-to-end: | ||
| 145 | |||
| 146 | ```bash | ||
| 147 | pip install pytest pexpect | ||
| 148 | |||
| 149 | # All Xen runtime tests (requires built image + KVM) | ||
| 150 | cd meta-virtualization | ||
| 151 | pytest tests/test_xen_runtime.py -v --machine qemux86-64 | ||
| 152 | |||
| 153 | # vxn/containerd tests only | ||
| 154 | pytest tests/test_xen_runtime.py -v -k "Vxn or Containerd" | ||
| 155 | |||
| 156 | # Skip network-dependent tests | ||
| 157 | pytest tests/test_xen_runtime.py -v -m "boot and not network" | ||
| 158 | ``` | ||
| 159 | |||
| 160 | The tests boot the image with `qemuparams="-m 4096"` to provide enough | ||
| 161 | memory for Dom0 + bundled guests + vxn/vctr guests. Tests detect | ||
| 162 | available features inside Dom0 and skip gracefully when components are | ||
| 163 | not installed. | ||
| 164 | |||
| 165 | See `tests/README.md` for full test documentation and `recipes-extended/images/README-xen.md` | ||
| 166 | for build prerequisites at each test tier. | ||
| 167 | |||
| 142 | ## Debugging | 168 | ## Debugging |
| 143 | 169 | ||
| 144 | ```bash | 170 | ```bash |
