Smoke tests
The Makefile drives all smoke suites. make smoke selects the right one for
the host: Firecracker on Linux, Apple VF on macOS.
Suites
Section titled “Suites”| Target | What it covers |
|---|---|
make smoke | Default per-host smoke suite |
make smoke-rootfs | OCI image to ext4 rootfs conversion |
make smoke-firecracker | Linux KVM Firecracker boot |
make smoke-workspace | HostOS workspace lifecycle |
make smoke-boot | Boot a Linux VM end-to-end (Apple VF) |
Firecracker boot smoke
Section titled “Firecracker boot smoke”Run from the microagent-kit checkout on a Linux amd64 host with KVM:
make smoke-firecrackerThis target must run outside sandboxed agent environments. It needs host KVM visibility, network access for OCI layer fetches, and normal writes to Microagent state paths.
The smoke:
- builds local
microagentandmicroagent-guestinitbinaries - installs the default Firecracker amd64 kernel
- verifies the kernel SHA
- builds a BusyBox OCI-backed rootfs
- boots with Firecracker
- runs
echo microagent-firecracker-boot-smokein the guest - verifies Firecracker exits cleanly
Expected kernel SHA:
4bbe8b2fd19f78fea4bf02d52a67482227a896c90a63f272b6a084fa46a416c0Expected output:
firecracker boot smoke passedkernel_sha=4bbe8b2fd19f78fea4bf02d52a67482227a896c90a63f272b6a084fa46a416c0microagent-kernels owns kernel build and release artifacts. Its matching
non-KVM check is:
make check-kernel-config-amd64Apple VF boot smoke
Section titled “Apple VF boot smoke”make signed-supervisor # build + ad-hoc sign the supervisormake smoke-bootThe smoke looks for the kernel at
~/.microagent/kernels/apple-vf/arm64/Image. The older
~/.microagent/kernels/apple-vf/Image path still works.