Lone Badger Tech

Bundles

One hash-verified file with everything a deploy needs, built once and deployed everywhere.

bsm bundle create                    # writes bsm-bundle-<plan head>.zip
bsm bundle create -o release-1.4.zip --no-config
bsm bundle verify release-1.4.zip
bsm --bundle release-1.4.zip status -e prod
bsm --bundle release-1.4.zip deploy -e prod

What is in a bundle

A zip file with bsm.plan, the folders of every planned change, repeatable/, the environment scripts under environments/, bsm.yaml (unless --no-config) and a manifest, bsm-bundle.json, listing each file's SHA-256, the provider, the plan head and a content hash that identifies the bundle.

Text is stored normalized (no byte-order mark, LF line endings) and entries are sorted with fixed timestamps, so the same commit produces a byte-identical bundle on Windows, macOS and Linux. A project with problems (bsm plan check errors) cannot be bundled.

Running from a bundle

--bundle <file> works with every command that reads the project: status, deploy, revert, rebase, verify, repair, diff-schema, render, vars, plan check and plan show. Before anything runs, bsm checks:

  • every file matches its hash, none is missing and none was added;
  • the manifest's content hash matches its file list;
  • the plan head computed from the extracted scripts equals the one in the manifest.

Any mismatch stops the run and names the files. The bundle is extracted to a temporary folder that is deleted on exit. Commands that write project files (add, tag, rework, init) refuse --bundle.

Configuration

When the bundle includes bsm.yaml, it is used, so the environments are frozen with the scripts. Secrets are never stored: keep them as ${env:NAME} or ${file:path} references, which resolve on the machine that deploys (relative paths from --project). Bundle with --no-config to read bsm.yaml from --project at deploy time instead.