Skip to content

feat(urunc-deploy): ship hluk and install it on the nodes - #1171

Open
danbugs wants to merge 3 commits into
urunc-dev:mainfrom
danbugs:urunc-deploy-hluk
Open

danbugs wants to merge 3 commits into
urunc-dev:mainfrom
danbugs:urunc-deploy-hluk

Conversation

@danbugs

@danbugs danbugs commented Oct 27, 2026

Copy link
Copy Markdown
Contributor

Description

urunc-deploy installs urunc and every hypervisor it drives on the nodes of a cluster, except hluk, the monitor of Hyperlight guests, which had to be put on the PATH of each node by hand. This ships hluk in the urunc-deploy image and installs it with the others, so a cluster runs Hyperlight images as soon as urunc-deploy has rolled out.

  • Image: a build stage downloads the hluk v0.18.0 release for the build architecture, checks it against the sums the release publishes, and places it next to the other hypervisors. hluk embeds the kernel it boots and its Linux releases are static, so the one binary is all a node needs. The version is a build argument, HLUK_VERSION, defaulting to the release, and the Dockerfile notes what it moves together with: HLUK_VERSION in vm_test.yml, hyperlight-unikraft in versions.yml and the test image tag.
  • Installer: hluk joins the default HYPERVISORS list of the DaemonSet and is copied to /opt/urunc/bin/hluk like the rest; uninstall already removes that directory. The shipped config.toml points the hyperlight-unikraft monitor at that path, which urunc takes over a PATH lookup. The path is only kept when urunc-deploy installed hluk: a deployment whose HYPERVISORS leaves it out keeps resolving a hand-installed hluk from the PATH as it does today, and URUNC_MONITORS_HYPERLIGHT_UNIKRAFT_PATH sets it either way.
  • Docs: the Kubernetes tutorial lists hluk among what urunc-deploy installs and documents HYPERVISORS; the hypervisor-support page says Kubernetes needs no manual install.
  • CI: the urunc-deploy test checks for the binary and boots docker.io/urunc/hello-hyperlight-unikraft:v0.18.0 on amd64, which prints its greeting through the installed hluk. That workflow runs nightly and on dispatch against the image built from main, so the new steps take effect once this is merged.

Related issues

Part of #140, following #1135.

How was this tested?

Built the image from this tree and ran the DaemonSet on a kind cluster (kindest/node v1.35.8, containerd 2.3.4). With the default HYPERVISORS, the node gets hluk 0.18.0 at /opt/urunc/bin/hluk, /etc/urunc/config.toml carries its path, and a runtimeClassName: urunc pod of docker.io/urunc/hello-hyperlight-unikraft:v0.18.0 prints "hello from Python 3.12.15 on Unikraft in a Hyperlight micro-VM, via urunc". With hluk removed from HYPERVISORS, nothing is installed and the path line is absent, with the comments of the file kept. The installer passes bash -n and shellcheck with no new findings, the workflow passes actionlint and cspell. No Go code changes; make lint reports nothing new and make test_docker passes except the Firecracker FreeBSD case, which asks docker for an io.containerd.urunc-fc.v2 runtime mine does not define.

LLM usage

Fable 5.1

Checklist

  • I have read the contribution guide.
  • The linter passes locally (make lint).
  • The e2e tests of at least one tool pass locally (make test_ctr, make test_nerdctl, make test_docker, make test_crictl).
  • If LLMs were used: I have read the llm policy.

urunc-deploy installs urunc and every hypervisor it drives, except hluk,
the monitor of Hyperlight guests, which had to be put on the PATH of each
node by hand.

A build stage downloads the hluk release for the build architecture,
checks it against the sums the release publishes and places it next to
the other hypervisors. hluk embeds the kernel it boots and its Linux
releases are static binaries, so that one file is all a node needs. The
version is a build argument with the release as its default, and the
Dockerfile notes what it moves together with.

hluk joins the default HYPERVISORS list of the DaemonSet and is copied to
/opt/urunc/bin like the rest; uninstall already removes that directory.
The shipped configuration points the hyperlight-unikraft monitor at that
path, which urunc takes over a PATH lookup. The path is only kept when
urunc-deploy installed hluk: a deployment whose HYPERVISORS leaves it out
keeps resolving a hand-installed hluk from the PATH as it does today, and
the URUNC_MONITORS_HYPERLIGHT_UNIKRAFT_PATH variable sets it either way.

Signed-off-by: danbugs <danilochiarlone@gmail.com>
The Kubernetes tutorial lists hluk among what urunc-deploy installs and
documents the HYPERVISORS variable of the DaemonSet, and the hypervisor
support page says that on Kubernetes there is nothing to install by hand.

Signed-off-by: danbugs <danilochiarlone@gmail.com>
The urunc-deploy test checks for the binary on the node and, on amd64,
runs the hello-hyperlight-unikraft image through the installed hluk,
which prints its greeting. The step describes the pod before reading its
logs, so a failure shows why.

Signed-off-by: danbugs <danilochiarlone@gmail.com>
@netlify

netlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for urunc ready!

Name Link
🔨 Latest commit cfdf812
🔍 Latest deploy log https://app.netlify.com/projects/urunc/deploys/6ae11d504e4683185006833d
😎 Deploy Preview https://deploy-preview-1171--urunc.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant