Skip to content

LamBoot v0.8.4

Choose a tag to compare

@glamberson glamberson released this 23 Apr 04:39
· 6 commits to main since this release

[0.8.4] — 2026-04-22

Release posture: coordinated lamboot v0.8.4 + lamboot-tools v0.2.0
per docs/CROSS-REPO-STATUS.md. v0.8.3 shipped the signing + audit
layer; v0.8.4 closes the Proxmox-toolkit coordination gaps so the
companion lamboot-tools v0.2.0 toolkit (11 tools across 3 RPM
subpackages) can ship alongside.

Tarball SHA256: 4671691f597627ee354f36e945dc5d68a75709af4524a88c5a6aa9ae87056830

Proxmox integration test on pve.a.lamco.io (VM 120): PASS on all 8
verifications. See docs/analysis/V0.8.4-PROXMOX-INTEGRATION-TEST-2026-04-22.md.

See also: lamco-admin/lamboot-tools v0.2.0.

Fixed

  • tools/lamboot-hookscript.pl rewritten to fw_cfg file-reference pattern (commit 2892446). Pre-0.8.4 hookscript called qm set --args during pre-start, which silently failed because Proxmox config-locks the VM config during that lifecycle phase. The rewrite removes all qm set calls: lamboot-pve-setup from the toolkit sets the permanent args: line once on a stopped VM, and this hookscript's pre-start job becomes writing /var/lib/lamboot/<VMID>.json for QEMU to expose via fw_cfg. Version header # version: 0.8.4 allows lamboot-pve-setup doctor-hookscript to detect and verify. See docs/specs/ + ~/lamboot-tools-dev/docs/SPEC-LAMBOOT-TOOLKIT-V1.md §11.2 for the full protocol.

Added

  • lamboot-install --toolkit-prompt (commit c4a9b4e). Interactive Install lamboot-tools for diagnostic and repair utilities? [y/N] prompt at the end of a successful install, plus --install-toolkit / --no-install-toolkit flag overrides for non-interactive scripts. Distro-aware install guidance: Fedora/RHEL/EPEL shows dnf copr enable lamco/lamboot-tools; Debian/Ubuntu/Arch shows the source-tarball URL with a note that native packaging lands in lamboot-tools v0.3. Skipped on --dry-run, --update, --quiet, or partial failure.
  • /etc/lamboot/fleet.toml schema v1 consumption (commits ada5cb6 + 2892446). Both tools/lamboot-monitor.py and tools/lamboot-hookscript.pl now read the shared fleet config authored as canonical in ~/lamboot-tools-dev/docs/SPEC-LAMBOOT-TOOLKIT-V1.md §16 Appendix C. Monitor seeds argparse defaults for --alert-webhook (HTTPS enforced) and --log-path from [monitor]. Hookscript reads [hookscript] inject flags plus [roles] explicit VMID mapping and [tags] tag-to-role mapping for per-VM role resolution. Additive with graceful fallback: missing file / missing TOML parser / wrong schema version / malformed TOML all fall back to hardcoded defaults so v0.8.4 is safe to deploy before fleet.toml exists.
  • docs/CROSS-REPO-STATUS.md (commit 51ce546). Rolling coordination tracker between lamboot-dev and lamboot-tools-dev per the toolkit spec §14.5. Mirror counterpart lives in the toolkit repo; owner perspectives flipped between them.

Changed

  • docs/LAMBOOT-TOOLS-OVERVIEW.md rewritten (commit 51ce546) to reflect the real state of the companion toolkit. Previously described "5 bash CLI utilities"; now describes 11 tools across 3 RPM subpackages (lamboot-tools, lamboot-migrate dual-pub, lamboot-toolkit-pve) with Copr-based install flow and Option 2 packaging architecture.
  • README.md adds "Diagnostic and repair utilities" section (commit b812fea) linking github.com/lamco-admin/lamboot-tools and cross-referencing CROSS-REPO-STATUS.md + the toolkit spec.
  • docs/STATUS-2026-04-22-TOOLKIT-PIVOT.md §9 "Post-Q state" appendix added (commit 51ce546). Captures what happened after the pivot doc was written: the toolkit repo ran its Session A–Q arc the same day, turning 5 v0.1.0 scripts into 11 production-grade tools; all 23 R1–R23 research questions from §4 of the pivot doc are resolved in ~/lamboot-tools-dev/docs/SPEC-LAMBOOT-TOOLKIT-V1.md; lamboot-migrate v1.0.0 ships SDS-7 in full. §1-§8 of the pivot doc preserved as historical record.
  • docs/ROADMAP.md "Toolkit Pivot" intro updated (commit 51ce546) with current toolkit state and CROSS-REPO-STATUS.md pointer.
  • docs/specs/SPEC-LAMBOOT-MIGRATE.md §14 reconciliation flipped to RESOLVED (commit 51ce546). The v1.0.0 implementation landed in lamboot-tools-dev Session C closes every gap from §14.1–§14.7, plus --remove-grub distro-aware cleanup beyond spec. Each row marked RESOLVED / RESOLVED+ / KEPT.

Added — should-have cross-references

  • docs/KEY-GENERATION.md §10 "Operator tooling" (commit 51ce546) back-links to lamboot-signing-keys in the toolkit; lists generate/rotate/enroll/sign-binary/revoke/list/show/verify/import/export subcommands.
  • docs/SECURE-BOOT-AND-SIGNING-STRATEGY.md "Operator tooling" (commit 51ce546) maps sign-binary/rotate/verify to procedures in the strategy doc.
  • docs/OVMF-VARS-PROXMOX.md §12 (commit 51ce546) notes lamboot-pve-ovmf-vars in the toolkit is a mirror of tools/build-ovmf-vars.sh here; canonical source stays in this repo.