Files
logpile/bible-local/08-build-release.md
T
Mikhail ChusavitinandClaude Sonnet 5 475318fc2b refactor: extract parsers and Redfish replay/analysis to external module
logpile no longer carries its own archive/vendor parsers or Redfish
raw-payload replay/analysis engine. Both now live in
git.mchus.pro/reanimator/parser/v13 (already used by the sibling `core`
project), reached through parser.NewService().AnalyzeArchivePayload /
AnalyzeRedfishRawPayloads. logpile keeps live BMC/Redfish collection,
the DB, exporter, server and UI.

- Deleted internal/parser/ (interface, registry, archive extraction,
  all vendor packages), internal/collector/redfish_replay*.go (replay
  engine, confirmed near-identical to the module's redfish/ package),
  internal/ingest/ (pure duplicate of the module's Service),
  internal/models/ (repointed every import to the module's models
  package instead), and internal/rar5 (only used by the deleted
  archive extractor). Removed the now-unused third_party/pciids
  submodule.
- internal/collector/redfish.go: Collect() now calls
  parser.NewService().AnalyzeRedfishRawPayloads(...) at the one place
  it used to call the local ReplayRedfishFromRawPayloads (an existing
  "unified tunnel" between live collection and raw import). A
  deadcode-driven pass then removed ~150 doc-to-model conversion
  helpers in redfish.go that duplicated the module's redfish/ package
  and were already unreachable before this change; kept the small
  generic dedup/scoring helpers the live crawler still calls.
- internal/collector/redfishprofile/ stays whole: Collect() depends on
  it directly for acquisition-time tuning. Its analysis-only methods
  (ApplyAnalysisProfiles/PostAnalyze) are now dead but left in place
  rather than splitting the package's single Profile interface.
- pciids moved with the module (now a public package there); logpile's
  live collector and exporter import it from there instead of keeping
  a local copy.
- go.mod: new require on git.mchus.pro/reanimator/parser/v13 v13.0.0
  (plain module dependency, not a submodule like reanimator/chart,
  since this module is independently versioned and shared with core).
- bible-local docs rewritten for the new boundary; see ADL-080.

See also the companion change in git.mchus.pro/reanimator/parser
(tagged v13.0.0): new top-level exports
(IsSupportedArchiveFilename/SupportedArchiveExtensions/
ParseInDefaultArchiveLocation/PrivacyScanEnabled) and pciids moved to
a public package, both needed to complete this migration.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-08 12:59:39 +03:00

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 build outputs bin/logpile
  • make build-all builds the supported cross-platform binaries

Private module dependency

logpile depends on git.mchus.pro/reanimator/parser/v13 (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:

  1. Reads version from git describe --tags
  2. Refuses a dirty tree unless ALLOW_DIRTY=1
  3. Sets stable Go cache/toolchain environment
  4. Creates releases/{VERSION}/
  5. Creates a release-notes template if missing
  6. Builds darwin-arm64 and windows-amd64
  7. Packages any already-present binaries from bin/
  8. Generates SHA256SUMS.txt

Release tag format:

  • project release tags use vN.M
  • do not create vN.M.P tags for LOGPile releases
  • release artifacts and main.version inherit the exact git tag string

Important limitation:

  • scripts/release.sh does not run make build-all for you
  • if you want Linux or additional macOS archives in the release directory, build them before running the script

Toolchain note:

  • scripts/release.sh defaults GOTOOLCHAIN=local to 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