Packer Build Evidence (How to Review)¶
This folder contains signed-off, timestamped proof that VM templates were built in Proxmox VE using HashiCorp Packer. Each successful run produces a human summary (README.md), a machine summary (proof.json), and the full Packer log (packer.log).
Quick Links (open the latest proofs)¶
- Init (one‑time bootstrap) → init/latest/README.md
Linux templates
- Ubuntu 22.04 (latest) → builds/ubuntu-22.04/latest/README.md
- Rocky Linux 9 (latest) → builds/rocky-9/latest/README.md
- Ubuntu 24.04 (latest) → builds/ubuntu-24.04/latest/README.md
Windows template - Windows Server 2022 (latest) → builds/windows-2022/latest/README.md
Tip: Each template folder also contains a history of prior runs (by UTC timestamp). Use the
latestlink above for the most recent successful build.
What’s inside each proof¶
Each build proof folder contains:
- README.md — plain‑English summary (timestamp, VMID, node, and template facts: CPU, disk, ISO/CDROM, network).
- proof.json — machine‑readable metadata (VMID, node, SHA‑256 checksum for the log, byte size).
- packer.log — complete build output with PACKER_LOG=1 enabled.
The init proof folder contains:
- README.md — summary of Proxmox bootstrap (API token/user, node/storage/bridge discovery).
- proof.json — metadata and a list of rendered unattended assets.
- init-packer.log — one‑time initialization log.
Integrity & Authenticity (no tooling required)¶
- Each build README states the SHA‑256 of the
packer.log. proof.jsonrepeats the same hash underlog_sha256.- Logs are immutable per timestamped folder, and a
latestsymlink always points to the most recent successful run.
How this evidence is produced¶
- Templates live under
infra/packer/(HCL + OS assets). - The build is executed via
bin/build-wrapper.shwhich streams to console and writes structured logs. - On success only,
bin/evidence_packer.shgenerates this proof (README + JSON + log) for the run. - The one‑time initialization proof is generated by the same evidence tool in init mode.
If a build fails, no proof is emitted—you’ll only see logs under output/logs/packer/... (useful for debugging, not for review).
Design rationale & runbooks¶
-
ADR‑0016 — Packer + Cloud‑Init VM Templates
docs/adr/ADR‑0016-packer-cloudinit-vm-templates.md -
Runbook — Proxmox VM Template Build
docs/ops/runbooks/platform/modules/packer-proxmox-template-build.md -
HOWTO — Build Your First Packer Template
docs/howtos/HOWTO_packer_proxmox_template.md
Contact¶
Maintainer: Jeleel Muibi (HybridOps.Studio)
For questions about provenance, process, or reproducibility, open the latest template proof (above) and use the referenced log + JSON to trace the exact build parameters and outcome.