https://github.com/imjasonh/kontain.me

Container image registry that serves images built fresh when you ask for them
https://github.com/imjasonh/kontain.me

build containers jit

Last synced: about 2 months ago
JSON representation

Container image registry that serves images built fresh when you ask for them

• Host: GitHub
• URL: https://github.com/imjasonh/kontain.me
• Owner: imjasonh
• License: apache-2.0
• Created: 2018-12-08T12:54:02.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2024-02-12T13:20:23.000Z (7 months ago)
• Last Synced: 2024-07-17T05:34:43.725Z (2 months ago)
• Topics: build, containers, jit
• Language: Go
• Homepage:
• Size: 4.46 MB
• Stars: 201
• Watchers: 5
• Forks: 12
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# kontain.me

[![CI](https://github.com/imjasonh/kontain.me/actions/workflows/ci.yaml/badge.svg?event=push)](https://github.com/imjasonh/kontain.me/actions/workflows/ci.yaml)

[![Deploy](https://github.com/imjasonh/kontain.me/actions/workflows/deploy.yaml/badge.svg)](https://github.com/imjasonh/kontain.me/actions/workflows/deploy.yaml)

Serving container images generated on-demand, at the time they are requested.

These include:

* [`random.kontain.me`](./cmd/random), which serves randomly-generated images.

* [`mirror.kontain.me`](./cmd/mirror), which pulls and caches images from other registries.

* [`flatten.kontain.me`](./cmd/flatten), which pulls and flattens images from other registries,

  so they contain only one layer.

* [`ko.kontain.me`](./cmd/ko), which builds a Go binary into a container image using

  [`ko`](https://github.com/google/ko).

* [`apko.kontain.me`](./cmd/apko), which builds a minimal base image containing

  APK packages, using [`apko`](https://apko.dev).

* [`wait.kontain.me`](./cmd/wait), which enqueues a background task to serve a

  random image after some amount of time.

This repo also serves [`viz.kontain.me`](./cmd/viz), which visualizes shared

image layers using [Graphviz](https://graphviz.org/).

# Caveats

* The registry does not accept pushes.

* This is a silly hack and probably isn't stable. Don't rely on it for anything

  serious.

* It could probably do a lot of smart things to be a lot faster. 🤷

* Blobs and manifests are cached for 24 hours wherever possible, but will be

  rebuilt from scratch after that time.

# How it works

The service is implemented using [Google Cloud

Run](https://cloud.google.com/run).

When the service receives a request for an image manifest, it parses the

request and generates layers for the requested image, writing the manifest and

blobs to [Google Cloud Storage](https://cloud.google.com/storage/). After it

receives the manifest, `docker pull` fetches the blobs. The app simply

redirects to Cloud Storage to serve manifests and blobs.