Move logpile to git.mchus.pro/reanimator/parser/v38 v38.0.0 (ADL-085). Add scripts/bump-parser.sh, which bumps the parser, tests, commits, tags the release as v<counter>.<parser major>, pushes and builds (ADL-086). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.2 KiB
08 — Build & Release
CLI flags
Defined in cmd/logpile/main.go:
| Flag | Default | Purpose |
|---|---|---|
--port |
8082 |
HTTP server port |
--file |
empty | Preload archive file |
--sanitize |
empty | De-identify customer data in this file and exit (docs/log-sanitization.md) |
--sanitize-out |
empty | Where --sanitize writes its result (default: overwrite the input) |
--version |
false |
Print version and exit |
--no-browser |
false |
Do not auto-open browser |
--hold-on-crash |
true on Windows |
Keep console open after fatal crash |
Common commands
make build
make build-all
make test
make fmt
Notes:
make buildoutputsbin/logpilemake build-allbuilds the supported cross-platform binaries
Private module dependency
logpile depends on git.mchus.pro/reanimator/parser/v38 (archive parsing, Redfish
replay/analysis, models, pciids — see ADL-080 in 10-decisions.md), a private Gitea
host. git.mchus.pro has no public Go checksum database entry, so a clean module cache
needs GOPRIVATE=git.mchus.pro/* set before go mod tidy/go build/go get can
resolve it (go env -w GOPRIVATE=git.mchus.pro/*), or a go.sum seeded from another
project that already depends on the same version. This is logpile's first non-replaced
external Go module dependency — CI must set GOPRIVATE accordingly.
PCI vendor/device ID data (pci.ids) now lives inside that module; logpile no longer
embeds its own copy or carries the third_party/pciids submodule.
Release script
Run:
./scripts/release.sh
Current behavior:
- Reads version from
git describe --tags - Refuses a dirty tree unless
ALLOW_DIRTY=1 - Sets stable Go cache/toolchain environment
- Creates
releases/{VERSION}/ - Creates a release-notes template if missing
- Builds
darwin-arm64andwindows-amd64 - Packages any already-present binaries from
bin/ - Generates
SHA256SUMS.txt
Release tag format (ADL-086):
- project release tags use
vC.P:Cis the release counter (highestNamong existingvN.Mtags + 1),Pis the major version of the parser module the release is built with - example:
v2.49(last old-style tag) ->v3.38(parser v38) ->v4.38->v5.39 - do not create
vN.M.Ptags for LOGPile releases - release artifacts and
main.versioninherit the exact git tag string
Parser bump script
./scripts/bump-parser.sh
Moves logpile to the latest published parser tag without manual edits:
- Refuses a dirty tree (except with
DRY_RUN=1) - Pulls the local parser checkout
../reanimator/parserif present and clean (best effort) - Finds the latest
vX.Y.Ztag onhttps://git.mchus.pro/reanimator/parser.git(override:PARSER_VERSION=v38.0.0); exits if already on it (unlessFORCE=1) - Rewrites
git.mchus.pro/reanimator/parser/vOLD->/vNEWincmd/,internal/(notinternal/chart) andbible-local/(not10-decisions.md), updatesgo.mod, runsgo mod tidy - Runs
go build,go vet,go teston./... - Computes the next
vC.Ptag from local +origintags - Commits
chore: update parser module to vX.Y.Zon the current branch, creates an annotated tag, pushes branch and tag (NO_PUSH=1skips the push) - Runs
make buildsobin/logpilecarries the new tag
DRY_RUN=1 does steps 1–6 and builds, but leaves changes uncommitted.
Routine parser bumps made by this script do not need their own ADL entry; record one only
when logpile code or behavior has to change for the new parser.
Important limitation:
scripts/release.shdoes not runmake build-allfor you- if you want Linux or additional macOS archives in the release directory, build them before running the script
Toolchain note:
scripts/release.shdefaultsGOTOOLCHAIN=localto use the already installed Go toolchain and avoid implicit network downloads during release builds- if you intentionally want another toolchain, pass it explicitly, for example
GOTOOLCHAIN=go1.24.0 ./scripts/release.sh
Run locally
./bin/logpile
./bin/logpile --port 9090
./bin/logpile --no-browser
./bin/logpile --version
macOS Gatekeeper
xattr -d com.apple.quarantine /path/to/logpile-darwin-arm64