Back to modules
v0.2.1

tinysystems/distribution-module

View Source

Container Image

europe-west2-docker.pkg.dev/tinyplatform/tinysystems/distribution-module-v0:0.2.1

Components 1 available

C

container_registry

OCI-compliant container registry server. Standalone mode: push and pull images directly. Pull-through cache mode: set upstream registry host and it transparently proxies requests, caching locally. Uses cuelabs ociregistry library. Mount a PVC with storage.enabled=true for persistence across restarts.

Release Notes

Tiny Systems Distribution Module

Container image distribution for edge and air-gapped Kubernetes environments.

Components

Component Description
Container Registry OCI-compliant registry server with standalone and pull-through cache modes

How it works

Standalone mode — a local registry that accepts push and pull. Configure a port, start it, push images.

Pull-through cache mode — set an upstream registry host (e.g., registry-1.docker.io). When a pod pulls an image, the registry fetches it from upstream and caches it locally. Subsequent pulls are served from cache. No deployment changes needed — just configure containerd to mirror through this registry.

Installation

helm repo add tinysystems https://tiny-systems.github.io/module/
helm install distribution-module tinysystems/tinysystems-operator \
  --set controllerManager.manager.image.repository=ghcr.io/tiny-systems/distribution-module \
  --set storage.enabled=true \
  --set storage.size=10Gi

Run locally

go run cmd/main.go run --name=distribution-module --namespace=tinysystems --version=1.0.0

Part of Tiny Systems

This module is part of the Tiny Systems platform -- a visual flow-based automation engine running on Kubernetes.

License

This module's source code is MIT-licensed. It depends on the Tiny Systems Module SDK (BSL 1.1). See LICENSE for details.