imagerefs

package
v0.17.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 4, 2026 License: Apache-2.0 Imports: 0 Imported by: 0

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

View Source
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.155.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.

View Source
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

View Source
const ElixirDefaultVersion = "1.19"

ElixirDefaultVersion is the Elixir minor used when an app doesn't pick one.

Variables

ElixirDefaultTag is the full hexpm tag for ElixirDefaultVersion on its default OTP.

View Source
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

func ElixirTag(minor, otpMajor string) string

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

func GetBunImage(version string) string

GetBunImage returns a Bun runtime image reference with the specified version

func GetElixirImage added in v0.17.0

func GetElixirImage(tag string) string

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

func GetGolangImage(version string) string

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

func GetNodeImage(version string) string

GetNodeImage returns a Node.js image reference with the specified version

func GetPythonImage

func GetPythonImage(version string) string

GetPythonImage returns a Python image reference with the specified version

func GetRubyImage

func GetRubyImage(version string) string

GetRubyImage returns a Ruby image reference with the specified version

func GetRustImage added in v0.2.0

func GetRustImage(version string) string

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL