Mikhail ChusavitinandClaude Sonnet 5
489dd2830c
On hosts where the boot medium is BMC/IPMI virtual media, the ~2.8 GB squashfs read often drops mid-transfer: rsync dies with "Input/output error (5)", every file "has vanished", and live-boot moves the partial RAM copy over the medium, ending the boot with "No supported filesystem images found at /live". Add hook 9013-toram-retry, which patches live-boot's 9990-toram-todisk.sh so the whole-medium copy runs in a retry loop: up to 8 attempts with a geometrically growing pause (15s -> 900s cap), unmounting/waiting/remounting the medium between tries and honouring rsync's exit code (upstream ignores it). rsync resumes from where it stopped, so a retry needing only the tail finishes fast. Verified against live-boot 1:20230131+deb12u1: substitution applies, sh -n is clean, hook is idempotent. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018JA6Cj84yxUfk8N3ppw6mr
ISO Build
bee ISO is built inside a Debian 12 builder container via iso/builder/build-in-container.sh.
Requirements
- Docker Desktop or another Docker-compatible container runtime
- Privileged containers enabled
- Enough free disk space for builder cache, Debian live-build artifacts, NVIDIA driver cache, and CUDA userspace packages
Build On macOS
From the repository root:
sh iso/builder/build-in-container.sh
The script defaults to linux/amd64 builder containers, so it works on:
- Intel Mac
- Apple Silicon (
M1/M2/M3/M4) via Docker Desktop's Linux VM
You do not need to pass --platform manually for normal ISO builds.
Useful Options
Build with explicit SSH keys baked into the ISO:
sh iso/builder/build-in-container.sh --authorized-keys ~/.ssh/id_ed25519.pub
Force a clean rebuild of the builder image and build caches:
sh iso/builder/build-in-container.sh --clean-build
Use a custom cache directory:
sh iso/builder/build-in-container.sh --cache-dir /path/to/cache
Notes
- The builder image is automatically rebuilt if the local tag exists for the wrong architecture.
- The live ISO boots with Debian
live-boottoram, so the read-only medium is copied into RAM during boot and the runtime no longer depends on the original USB/BMC virtual media staying present. - Target systems need enough RAM for the full compressed live medium plus normal runtime overhead, or boot may fail before reaching the TUI.
- The NVIDIA variant installs DCGM 4 packages matched to the CUDA user-mode driver major version. For driver branch
580/ CUDA13.x, the package family isdatacenter-gpu-manager-4-cuda13rather than legacydatacenter-gpu-manager. - Override the container platform only if you know why:
BEE_BUILDER_PLATFORM=linux/amd64 sh iso/builder/build-in-container.sh
- The shipped ISO is still
amd64. - Output ISO artifacts are written under
dist/.