Build A QEMU Bundle¶
Use this guide when you need a portable local artifact for the current QEMU AArch64 prototype.
Build¶
ct run image-bundle
The output is:
build/artifacts/den-qemu-aarch64.tar.zst
Verify¶
ct run image-bundle-smoke
This extracts the bundle into build/image-bundle-smoke, verifies checksums,
and boots from the extracted files.
Boot Manually¶
Extract the bundle:
tar -xf build/artifacts/den-qemu-aarch64.tar.zst -C /tmp
cd /tmp/den-qemu-aarch64
Boot normally:
./boot-qemu.sh
Run the deterministic smoke:
./boot-qemu.sh --smoke
Use a different QEMU binary:
./boot-qemu.sh --qemu /path/to/qemu-system-aarch64
Use more memory:
./boot-qemu.sh --memory 4096
Append extra kernel command-line text:
./boot-qemu.sh --append "systemd.log_level=debug"
Bundle Contents¶
Image
rootfs.cpio.gz
den-rootfs.ext4
boot-qemu.sh
manifest.toml
SHA256SUMS
receipt.json
den-rootfs.ext4.receipt.json
receipt.json is an in-toto Statement receipt. It can be checked with:
den verify qemu-bundle --target qemu-aarch64
The bundle is a prototype artifact for local boot and smoke testing. It is not yet a signed release image or installer.
For Docker/OCI and UEFI disk image forms, see Build OCI And UEFI Images.