Documentation
¶
Overview ¶
Package imagerefs centralizes all Docker image references used throughout the project. This provides a single source of truth for image versions and makes updates easier.
Index ¶
- Constants
- Variables
- func ElixirTag(minor, otpMajor string) string
- func GetBunImage(version string) string
- func GetElixirImage(tag string) string
- func GetGolangImage(version string) string
- func GetNodeImage(version string) string
- func GetPythonImage(version string) string
- func GetRubyImage(version string) string
- func GetRustImage(version string) string
- type ElixirRelease
Constants ¶
const ( // etcd distributed key-value store (gcr.io/etcd-development/etcd) Etcd = "oci.miren.cloud/etcd:v3.5.15" // Kubernetes pause container for sandboxes (registry.k8s.io/pause) Pause = "oci.miren.cloud/pause:3.8" // BuildKit daemon for building containers (docker.io/moby/buildkit), // v0.34.1 pinned by its index digest. A running server recreates its // buildkit container when this changes, keeping the build cache. BuildKit = "oci.miren.cloud/moby/buildkit@sha256:99368f3e46177c6405b9740e4461d91cee004128daeecca78d4ceac50ec1da5c" // Minio object storage server (quay.io/minio/minio) Minio = "oci.miren.cloud/minio:RELEASE.2025-04-03T14-56-28Z" // VictoriaLogs log storage server (docker.io/victoriametrics/victoria-logs). // v1.52.0 includes all-field LogsQL filters. Keep the multi-platform manifest // digest pinned; Miren snapshots data before changes that may migrate its // storage format. A pre-snapshot Miren binary still needs manual data restore. VictoriaLogs = "oci.miren.cloud/victoria-logs@sha256:47b820890d64c4575a2a0a46415dcd8a4fd59a0f1fcd6a377693d7aea639442e" // VictoriaMetrics metrics storage server (docker.io/victoriametrics/victoria-metrics) VictoriaMetrics = "oci.miren.cloud/victoria-metrics:v1.106.1" // vmagent Prometheus scraper and remote-write forwarder (docker.io/victoriametrics/vmagent) VMagent = "oci.miren.cloud/vmagent:v1.150.0" // Miren runtime server Miren = "oci.miren.cloud/miren:latest" )
Infrastructure images. These reference exact upstream version tags served through the oci.miren.cloud pull-through cache (RFD-87): the proxy aliases each name to its real upstream registry (gcr.io, registry.k8s.io, ghcr.io, quay.io, Docker Hub). They were previously pinned to opaque "v1" tags from the hand-maintained mirror; that mirror is retired, though the old v1 tags stay frozen in the registry so already-deployed clusters keep resolving them through the proxy's legacy-tag bypass.
const ( // Default Alpine Linux base image AlpineDefault = "oci.miren.cloud/alpine:3.21" // Default Busybox image BusyboxDefault = "oci.miren.cloud/busybox:1.37-musl" // GoRuntimeStatic is the runtime base for pure-Go (cgo-disabled) builds: // a fully static binary lands here, yielding the canonical tiny Go image. // distroless/static ships ca-certificates, tzdata, and a nonroot user but // no shell or libc (docker.io/... proxied to gcr.io/distroless). GoRuntimeStatic = "oci.miren.cloud/distroless/static-debian12:nonroot" // DebianSlim is the runtime base for builds that need glibc at runtime // (cgo) or that carry a runtime filesystem the static image can't hold // (e.g. JS-augmented assets). It has a shell, apt, and glibc. DebianSlim = "oci.miren.cloud/debian:bookworm-slim" )
Base images for language stacks
const ElixirDefaultVersion = "1.19"
ElixirDefaultVersion is the Elixir minor used when an app doesn't pick one.
Variables ¶
var ElixirDefaultTag = ElixirTag(ElixirDefaultVersion, ElixirReleases[ElixirDefaultVersion].DefaultOTP)
ElixirDefaultTag is the full hexpm tag for ElixirDefaultVersion on its default OTP.
var ElixirReleases = map[string]ElixirRelease{ "1.16": {Patch: "1.16.3", DefaultOTP: "26", OTP: map[string]string{"24": "24.3.4.17", "25": "25.3.2.21", "26": "26.2.5.21"}}, "1.17": {Patch: "1.17.3", DefaultOTP: "27", OTP: map[string]string{"25": "25.3.2.21", "26": "26.2.5.21", "27": "27.3.4.18"}}, "1.18": {Patch: "1.18.5", DefaultOTP: "27", OTP: map[string]string{"25": "25.3.2.21", "26": "26.2.5.21", "27": "27.3.4.18"}}, "1.19": {Patch: "1.19.6", DefaultOTP: "28", OTP: map[string]string{"26": "26.2.5.21", "27": "27.3.4.18", "28": "28.5.0.7"}}, "1.20": {Patch: "1.20.4", DefaultOTP: "28", OTP: map[string]string{"27": "27.3.4.18", "28": "28.5.0.7", "29": "29.1.1"}}, }
ElixirReleases is keyed by Elixir minor version ("1.19").
Functions ¶
func ElixirTag ¶ added in v0.17.0
ElixirTag returns the hexpm tag for an Elixir minor and OTP major from ElixirReleases, or "" when that pairing isn't in the table.
func GetBunImage ¶
GetBunImage returns a Bun runtime image reference with the specified version
func GetElixirImage ¶ added in v0.17.0
GetElixirImage returns a hexpm/elixir builder image reference for the given full hexpm tag (e.g. ElixirDefaultTag). It keeps the hexpm/ namespace rather than a bare "elixir", which on Docker Hub is a different image with different tags.
func GetGolangImage ¶
GetGolangImage returns a Golang builder image reference with the specified version. The Go stack builds on the glibc/bookworm variant (not alpine/musl) so cgo works out of the box: bookworm ships a C toolchain, and glibc is the lingua franca of the prebuilt-binary world (MIR-1248). The build then copies the resulting binary onto a minimal runtime base (see GoRuntimeStatic / DebianSlim) so the heavyweight toolchain never reaches the final image.
func GetNodeImage ¶
GetNodeImage returns a Node.js image reference with the specified version
func GetPythonImage ¶
GetPythonImage returns a Python image reference with the specified version
func GetRubyImage ¶
GetRubyImage returns a Ruby image reference with the specified version
func GetRustImage ¶ added in v0.2.0
GetRustImage returns a Rust image reference with the specified version
Types ¶
type ElixirRelease ¶ added in v0.17.0
type ElixirRelease struct {
// Patch is the full Elixir version built for this minor.
Patch string
// OTP maps each supported OTP major to the full OTP version built.
OTP map[string]string
// DefaultOTP is the OTP major used when none is asked for.
DefaultOTP string
}
ElixirRelease is the build we use for one Elixir minor version.