summaryrefslogtreecommitdiffstats
path: root/recipes-core/vxn
diff options
context:
space:
mode:
authorBruce Ashfield <bruce.ashfield@gmail.com>2026-02-25 04:38:28 +0000
committerBruce Ashfield <bruce.ashfield@gmail.com>2026-02-26 01:05:02 +0000
commit506d5af230f0b41809dfe754e84d5611b75c6585 (patch)
treedfa2cc520f6fe1ecb867c0373d6eb353e89977d4 /recipes-core/vxn
parentefccccda627426319d4ced3b8c8467962a69e30c (diff)
downloadmeta-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.md26
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
144Automated runtime tests boot xen-image-minimal and verify vxn end-to-end:
145
146```bash
147pip install pytest pexpect
148
149# All Xen runtime tests (requires built image + KVM)
150cd meta-virtualization
151pytest tests/test_xen_runtime.py -v --machine qemux86-64
152
153# vxn/containerd tests only
154pytest tests/test_xen_runtime.py -v -k "Vxn or Containerd"
155
156# Skip network-dependent tests
157pytest tests/test_xen_runtime.py -v -m "boot and not network"
158```
159
160The tests boot the image with `qemuparams="-m 4096"` to provide enough
161memory for Dom0 + bundled guests + vxn/vctr guests. Tests detect
162available features inside Dom0 and skip gracefully when components are
163not installed.
164
165See `tests/README.md` for full test documentation and `recipes-extended/images/README-xen.md`
166for build prerequisites at each test tier.
167
142## Debugging 168## Debugging
143 169
144```bash 170```bash