mirror of https://github.com/joelhooks/joelclaw.git synced 2026-09-19 01:24:04 +08:00

Files

T

Joel Hooks a4e602f7cf Add Firecracker infra README with image download instructions, gitignore binary images

Pre-downloaded vmlinux-6.1.155 (16MB) and ubuntu-24.04.squashfs (100MB) from
Firecracker CI build 20260107. Binary images gitignored — download instructions
in README. Firecracker v1.15.0 aarch64 binary available.

2026-03-16 08:35:50 -07:00

1.5 KiB

Raw Permalink Blame History

Firecracker MicroVM Infrastructure

ADR-0230: Firecracker MicroVM Agent Sandboxes

Setup

Prerequisites

Colima with nestedVirtualization: true (requires VZ framework, Apple Silicon)
/dev/kvm accessible inside the Colima VM

Guest Images

Download from Firecracker CI (not committed to git):

BUILD="20260107-89702a77e4c2-0"
mkdir -p infra/firecracker/images
curl -sL "https://s3.amazonaws.com/spec.ccfc.min/firecracker-ci/${BUILD}/aarch64/vmlinux-6.1.155" \
  -o infra/firecracker/images/vmlinux-6.1.155
curl -sL "https://s3.amazonaws.com/spec.ccfc.min/firecracker-ci/${BUILD}/aarch64/ubuntu-24.04.squashfs" \
  -o infra/firecracker/images/ubuntu-24.04.squashfs

Firecracker Binary

FC_VERSION="v1.15.0"
curl -sL "https://github.com/firecracker-microvm/firecracker/releases/download/${FC_VERSION}/firecracker-${FC_VERSION}-aarch64.tgz" \
  -o /tmp/firecracker-${FC_VERSION}-aarch64.tgz
tar xzf /tmp/firecracker-${FC_VERSION}-aarch64.tgz
# Install inside Colima VM:
colima ssh -- sudo cp release-${FC_VERSION}-aarch64/firecracker-${FC_VERSION}-aarch64 /usr/local/bin/firecracker
colima ssh -- sudo chmod +x /usr/local/bin/firecracker

Files

File	Purpose
`stages.json`	10-step execution DAG for workload planner
`images/`	Guest kernel + rootfs (gitignored, downloaded from CI)
`README.md`	This file

Architecture

macOS (M4 Pro) → Colima VM (VZ, aarch64, nested virt) → /dev/kvm → Firecracker microVMs

1.5 KiB Raw Permalink Blame History