RackPeek/Shared.Rcl/wwwroot/raw_docs/versioning.md

Versioning

RackPeek follows Semantic Versioning (SemVer) for both the CLI and Docker images:

MAJOR.MINOR.PATCH
Example: 1.2.3

MAJOR (X.0.0)

Breaking changes:

• CLI command/flag changes
• config.yaml structure changes
• Removed/renamed fields
• Behavior requiring migration

MINOR (1.X.0)

Backward-compatible features:

• New CLI commands or flags
• New WebUI features
• New non-breaking config options
• Performance improvements

PATCH (1.0.X)

Backward-compatible fixes:

• Bug fixes
• Security patches
• Docs / minor UX improvements

CLI & Docker

The CLI binary and Docker image share the same version number.

Docker tags:

• latest → newest stable release
• v1.2.3 → exact immutable version (recommended for production)

For production, pin to a specific version instead of latest.

Nightly Docker Builds

In addition to stable releases, RackPeek publishes a nightly Docker image from the staging branch.

• Triggered on every push to staging
• Built for linux/amd64

• Tagged as:

  • aptacode/rackpeek:nightly
  • aptacode/rackpeek:nightly-<short-sha>

Nightly images provide early access to upcoming changes and are intended for testing and development (not production use).