2.8 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/v31 (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:
- project release tags use
vN.M - do not create
vN.M.Ptags for LOGPile releases - release artifacts and
main.versioninherit the exact git tag string
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