Skip to content

install.md

Latest commit

 

History

History
83 lines (57 loc) · 2.06 KB

install.md

File metadata and controls

83 lines (57 loc) · 2.06 KB

Install

Bering v0.3.3 is the current product release. It emits io.mb3r.bering.model@1.1.0 and io.mb3r.bering.snapshot@1.1.0 by default, while still validating the preserved 1.0.0 contracts.

Binary Archives

Download the archive matching your platform from the GitHub Release assets and verify it against release-checksums.txt.

Supported release targets:

  • linux/amd64
  • linux/arm64
  • darwin/amd64
  • darwin/arm64
  • windows/amd64

Example release asset names for v0.3.3:

  • bering_0.3.3_linux_amd64.tar.gz
  • bering_0.3.3_linux_arm64.tar.gz
  • bering_0.3.3_darwin_amd64.tar.gz
  • bering_0.3.3_darwin_arm64.tar.gz
  • bering_0.3.3_windows_amd64.zip

Example:

tar -xzf bering_0.3.3_linux_amd64.tar.gz
./bering help

Build from source:

go build ./cmd/bering

OCI Image

Pull the published runtime image:

docker pull ghcr.io/mb3r-lab/bering:v0.3.3
docker run --rm ghcr.io/mb3r-lab/bering:v0.3.3 help

The release manifest records all published image references and the final digest in oci_images.

OCI Helm Chart

Install directly from the published OCI chart:

helm install bering oci://ghcr.io/mb3r-lab/charts/bering --version 0.3.3

Override the image repository, tag, or digest if you mirror artifacts:

helm install bering oci://ghcr.io/mb3r-lab/charts/bering --version 0.3.3 \
  --set image.repository=ghcr.io/mb3r-lab/bering \
  --set image.digest=sha256:...

Contracts Pack

Download bering-contracts_<version>.tar.gz to consume the public schema contracts offline:

tar -xzf bering-contracts_0.3.3.tar.gz
cat contracts-manifest.json

The pack contains:

  • contracts-manifest.json
  • contracts-manifest.schema.json
  • schema/model/v1.0.0/model.schema.json
  • schema/model/v1.1.0/model.schema.json
  • schema/snapshot/v1.0.0/snapshot.schema.json
  • schema/snapshot/v1.1.0/snapshot.schema.json

The contracts pack version is the Bering product release version. The schema contracts inside it remain independently versioned and stay pinned to their own name@version values.