Hyperlight KubeCon NA 2024 Demo

This repo houses the code for the demo we will be presenting during our keynote at KubeCon NA 2024.

Project Structure

.
├── Cargo.lock
├── Cargo.toml
├── README.md
├── demo-guest
├── demo-main
├── puml
└── target

• demo-guest: x86_64-hyperlight-none native Hyperlight guest application (built separately with cargo hyperlight).
• demo-main: HTTP server using Hyperlight's host SDK.

demo-guest

Hyperlight executes arbitrary code safely and quickly. It does that by booting up an OS-less VM that executes functions.

• demo-guest exports two guest functions:
  • PrintOutput, and
  • DereferenceRawNullPointer.

Note: OS-less VMs cannot make any syscalls, so we escape the VM to make host function calls to, say, print to standard output.

demo-main

Prerequisites

• Rust 1.89+ (pinned via rust-toolchain.toml)
• cargo-hyperlight: install with cargo install cargo-hyperlight

How to run?

# 1. Build the guest binary
cd demo-guest
cargo hyperlight build --release
cd ..

# 2. Copy the guest binary where demo-main expects it
cp demo-guest/target/x86_64-hyperlight-none/release/demo-guest demo-main/demo-guest-release

# 3. Run the host
cd demo-main
cargo run --release

How to debug?

To spawn a Hyperlight VM and attach a debugger to it, you:

1. Start a devcontainer
2. Build the guest in debug mode and copy the binary:

cd demo-guest
cargo hyperlight build
cp target/x86_64-hyperlight-none/debug/demo-guest ../demo-main/demo-guest-debug
cd ..

3. Run the demo with the gdb feature:

cd demo-main
cargo run --features gdb

4. Open a separate terminal and send an HTTP request to the demo server to spawn a cold Hyperlight VM:

curl http://localhost:3030/hyperlight/hello-world/cold

5. Attach a debugger to the spawned VM by using one of the Run and Debug configurations in your VSCode editor:

• Remote LLDB attach
• Remote GDB attach

6. Enjoy debugging!