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.