Skip to content
Brokkr

Container Images Reference

This reference documents Brokkr’s container images, repository locations, tag formats, and image characteristics. For build and publish procedures, see Building and Publishing Images.

Image Repositories

Section titled “Image Repositories”

The broker and agent images are published to GitHub Container Registry (GHCR) under the colliery-io organization; the UI is a local-only demo build.

Available Images

Section titled “Available Images”
Component Repository Purpose
Broker ghcr.io/colliery-io/brokkr-broker Central management service; also serves the embedded Operator Console at / on port 3000
Agent ghcr.io/colliery-io/brokkr-agent Kubernetes cluster agent
UI n/a — local build only (docker/Dockerfile.ui-slim) Administrative web interface — demo only; not currently built or published by CI

Supported Architectures

Section titled “Supported Architectures”

All images support the following platforms:

  • linux/amd64 - x86_64 architecture
  • linux/arm64 - ARM64/aarch64 architecture

Tag Format Specifications

Section titled “Tag Format Specifications”

Semantic Version Tags

Section titled “Semantic Version Tags”

Created when a git tag matching v*.*.* is pushed. The image tags carry no v prefix.

Tag Format Example Description Mutable
{major}.{minor}.{patch} 1.2.3 Full semantic version No
{major}.{minor} 1.2 Latest patch in minor version Yes
{major} 1 Latest minor in major version Yes
latest latest Most recent stable release Yes

Example: Tagging release v1.2.3 creates:

ghcr.io/colliery-io/brokkr-broker:1.2.3
ghcr.io/colliery-io/brokkr-broker:1.2
ghcr.io/colliery-io/brokkr-broker:1
ghcr.io/colliery-io/brokkr-broker:latest

Branch Tags

Section titled “Branch Tags”

Created for pushes to tracked branches.

Tag Format Example Description Mutable
{branch-name} main Branch name (sanitized) Yes
nightly nightly Latest nightly build (broker + agent) Yes

Example: Push to main branch creates:

ghcr.io/colliery-io/brokkr-broker:main

Pull Request Tags

Section titled “Pull Request Tags”

Created for pull request builds.

Tag Format Example Description Mutable
pr-{number} pr-123 Pull request number Yes

Example: PR #123 creates:

ghcr.io/colliery-io/brokkr-broker:pr-123

Image Digests

Section titled “Image Digests”

Every image has a unique SHA256 digest that never changes:

ghcr.io/colliery-io/brokkr-broker@sha256:9fc91fae0f07c60ccbec61d86ff93fe825f92c42e5136295552ae196200dbe86

A digest reference is immutable: it always resolves to the same image content, whereas mutable tags (1.2, 1, latest, branch tags) move as new images are published.

There is no immutable per-commit tag. Branch, PR, and nightly tags are all overwritten by the next build of the same ref, so pin by digest (or by a full {major}.{minor}.{patch} release tag) when you need a reference that cannot move under you.

Inspecting Images

Section titled “Inspecting Images”

View Manifest

Section titled “View Manifest”
Terminal window
docker manifest inspect ghcr.io/colliery-io/brokkr-broker:1.2.3

List Available Tags

Section titled “List Available Tags”

Visit the package page:

https://github.com/orgs/colliery-io/packages/container/brokkr-broker

Check Image Architecture

Section titled “Check Image Architecture”
Terminal window
docker image inspect ghcr.io/colliery-io/brokkr-broker:1.2.3 | grep Architecture

Image Layer Structure

Section titled “Image Layer Structure”

The broker and agent images are two-stage builds: a rust:1.90-slim-bookworm builder stage compiles the release binary, and a debian:bookworm-slim runtime stage carries only that binary and its runtime libraries.

Image Builder stage Runtime stage
Broker Compiles the Operator Console to WebAssembly with trunk, then builds brokkr-broker with the console embedded in the binary Debian slim + libpq; runs as root; exposes 3000
Agent Builds brokkr-agent Debian slim + libpq and a pinned kubectl; runs as the non-root brokkr user (UID 10001); exposes 8080

Neither image uses a dependency-caching build stage, so a change anywhere in the workspace recompiles the whole tree. Build internals are covered in Building and Publishing Images. The ui-slim image (examples/ui-slim) is a single-stage Node.js Alpine demo build, not built or published by CI.

Image Size Reference

Section titled “Image Size Reference”

Approximate compressed image sizes (Broker and Agent are the released, CI-published images; UI is the local-only demo build):

Component AMD64 ARM64
Broker ~60 MB ~58 MB
Agent ~65 MB ~62 MB
UI (demo, not published) ~40 MB ~38 MB

Note: Sizes vary by release and dependency versions

Section titled “Related Documentation”