Repository navigation
feat(monitor): add hvi monitor implementation - #1149
Open
Nachiket-Roy wants to merge 3 commits into
Open
Nachiket-Roy wants to merge 3 commits into
Nachiket-Roy wants to merge 3 commits into
Conversation
Nachiket-Roy
force-pushed
the
feat/hvi-vmm
branch
from
October 21, 2026 15:55
697b352 to
d32f230
Compare
👷 Deploy request for urunc pending review.Visit the deploys page to approve it
|
cmainas
reviewed
Nov 13, 2026
cmainas
left a comment
Contributor
There was a problem hiding this comment.
Thank you @Nachiket-Roy,
a few comments:
- Have you tried this e2e with an image targetting hvi?
- We add a new test case that uses hvi, but we do not update the CI to install hvi.
- The urunc-deploy installation scripts install hvi which does not exist in the container where the script runs.
- The hvi BuildExecCmd calls unikernel implementations and no unikernel implementation has been updated with hvi.
- We need to add an entry for hvi in https://github.com/urunc-dev/urunc/blob/main/docs/design/seccomp.md
Introduce the HVI monitor implementation for interacting with the hvi microVMM. Support building the execution command line for booting Linux guests, including kernel, initramfs, memory, vCPUs, TAP networking, block devices (max 4), virtiofs over vhost-user, and seccomp sandboxing. Register HviVmm in the VMM factory map and enable the (hvi, linux) guest-monitor pair in annotations validation and linux unikernel. Signed-off-by: Nachiket Roy <nachiket.roy.2@gmail.com>
Add default monitor configuration for hvi (256 MB memory, 1 vCPU) in urunc configuration. Signed-off-by: Nachiket Roy <nachiket.roy.2@gmail.com>
Document the hvi microVMM across urunc documentation: - Add hvi description and architecture integration in hypervisor-support.md - Add installation instructions from source in installation.md - Add hvi configuration options in configuration.md - Update matrix tables in README.md, index.md, and unikernel-support.md - Add seccomp integration details for hvi in design/seccomp.md - Add hvi to package annotations documentation Signed-off-by: Nachiket Roy <nachiket.roy.2@gmail.com>
Nachiket-Roy
force-pushed
the
feat/hvi-vmm
branch
from
November 14, 2026 12:16
d32f230 to
1924fe3
Compare
Contributor
Author
|
Hey @cmainas Thanks for the issues. I have fixed majority of them. Please take a look again
Removed until Nubificus publishes it.
Yes, removed since it is build from source
it was added in later commit. I have fixed the commit order
Done |
Contributor
|
Hello @Nachiket-Roy ,
Please verify this e2e. Creating an image that targets hvi is a few commands... |
Contributor
Author
Done. Image- ghcr.io/nachiket-roy/busybox-hvi-linux-raw:latest logs: [2026-11-16T18:17:32Z INFO virtiofsd] Waiting for vhost-user socket connection...
booting /cntrRootfs/.boot/kernel with 256 MiB ...
[hvi] virtio-net: tap tap0_urunc
[hvi] virtio-fs[0]: "fs0" on /tmp/vhostqemu
[2026-11-16T18:17:32Z INFO virtiofsd] Client connected, servicing requests
[hvi] 1 vCPU(s) vmlinux entry@0x1000123
[hvi] seccomp: on (vmm 48 syscalls, vcpu 40, trap on mismatch; open is refused)
[ 0.000000] Linux version 6.12.36 (@b702d6ef5e06) (gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0, GNU ld (GNU Binutils for Ubuntu) 2.38) #1 SMP Sun Jul 20 19:15:21 UTC 2025
[ 0.000000] Command line: panic=-1 console=ttyS0 root=fs0 rw rootfstype=virtiofs ip=10.4.0.2::10.4.0.1:255.255.255.0:urunc:eth0:off retain_initrd URUNIT_CONFIG=/sys/firmware/initrd init=/urunit console=ttyS0 -- /bin/sh
[ 0.000000] Disabled fast string operations
[ 0.000000] BIOS-provided physical RAM map:
[ 0.000000] BIOS-e820: [mem 0x0000000000000000-0x000000000009fbff] usable
[ 0.000000] BIOS-e820: [mem 0x0000000000100000-0x000000000fffffff] usable
[ 0.000000] NX (Execute Disable) protection: active
[ 0.000000] APIC: Static calls initialized
[ 0.000000] DMI not present or invalid.
[ 0.000000] Hypervisor detected: KVM
[ 0.000000] kvm-clock: Using msrs 4b564d01 and 4b564d00
[ 0.000000] kvm-clock: using sched offset of 22180971 cycles
[ 0.000007] clocksource: kvm-clock: mask: 0xffffffffffffffff max_cycles: 0x1cd42e4dffb, max_idle_ns: 881590591483
...
[ 0.065013] smp: Brought up 1 node, 1 CPU
[ 0.065424] smpboot: Total of 1 processors activated (5376.00 BogoMIPS)
[ 0.066061] Memory: 229868K/261752K available (12288K kernel code, 1050K rwdata, 2336K rodata, 1148K init, 2576K bss, 29928K reserved, 0K cma-reserved)
[ 0.067351] devtmpfs: initialized
[ 0.067417] x86/mm: Memory block size: 128MB
[ 0.067981] clocksource: jiffies: mask: 0xffffffff max_cycles: 0xffffffff, max_idle_ns: 7645041785100000 ns
[ 0.068803] futex hash table entries: 256 (order: 2, 16384 bytes, linear)
[ 0.069627] NET: Registered PF_NETLINK/PF_ROUTE protocol family
[ 0.070361] audit: initializing n
5, rootpath=
[ 0.149458] RAMDISK: Couldn't find valid RAM disk image starting at 0.
[ 0.150520] VFS: Mounted root (virtiofs filesystem) on device 0:19.
[ 0.151511] devtmpfs: error mounting -2
[ 0.151977] Freeing unused kernel image (initmem) memory: 1148K
[ 0.152271] Write protecting the kernel read-only data: 16384k
[ 0.154052] Freeing unused kernel image (rodata/data gap) memory: 1760K
[ 0.154382] Run /urunit as init process
Warning: No configuration for block mounts
/bin/sh: can't access tty; job control turned off
/ # |
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Added HVI microVMM support to urunc for running Linux unikernels. It introduces the HVI monitor implementation, integrates it with the VMM factory, and adds support for kernel boot parameters, initramfs, memory and vCPU configuration, TAP networking, block devices, virtiofs, and seccomp sandboxing.
It also adds HVI-specific annotation validation, default configuration and deployment support, end-to-end test coverage, and documentation for installation and usage.
Related issues
How was this tested?
Performed manual end-to-end verification of the OCI container lifecycle using
uruncwith the new HVI VMM integration.make urunc_dynamic.vmlinux) and HVI-specific annotations.unshare.create: Resolved HVI annotations, prepared mounts and device nodes, and recorded container state.start: Successfully invoked the HVI VMM and transitioned the container torunning.kill: Successfully dispatchedSIGKILLthroughHVI.Signal.delete: Successfully cleaned up the monitor rootfs, mounts, and container state.All four lifecycle operations completed successfully.
LLM usage
Used Gemini 3.8 and Opus 4.6
Checklist
make lint).make test_ctr,make test_nerdctl,make test_docker,make test_crictl).