separate READMEs

cmd/buildpack/README.md

@@ -0,0 +1,9 @@
+# `buildpack.kontain.me`
+
+`docker pull buildpack.kontain.me/[ghuser]/[ghrepo]:[revision]` serves an image
+fetched from source on GitHub and built using [CNCF
+Buildpacks](https://buildpacks.io)
+
+For example, `docker pull
+buildpack.kontain.me/buildpack/sample-java-app:b032838` fetches, builds and
+serves a [sample Java app](https://github.com/buildpack/sample-java-app).

cmd/flatten/README.md

@@ -0,0 +1,10 @@
+# `flatten.kontain.me`
+
+`docker pull flatten.kontain.me/[image]` will pull an image (if it can), then
+flatten its layers into a single layer.
+
+For example, `docker pull flatten.kontain.me/busybox` will pull `busybox` from
+Dockerhub and flatten it. Only public images are supported.
+
+_Flattening images obviates image layer caching, so it's often not an
+optimization._

cmd/ko/README.md

@@ -0,0 +1,9 @@
+# `ko.kontain.me`
+
+`docker pull ko.kontain.me/ko/[import path]` serves an image containing a Go
+binary fetched using `go get` and built into a container image using
+[ko](https://github.com/google/ko).
+
+For example, `docker pull ko.kontain.me/ko/github.com/google/ko/cmd/ko` will
+fetch, build and (eventually) serve a Docker image containing `ko` itself.
+_Koception!_

cmd/mirror/README.md

@@ -0,0 +1,13 @@
+# `mirror.kontain.me`
+
+`docker pull mirror.kontain.me/[image]` will pull the an image (if it can) and
+cache the manifest and layers. Subsequent pulls will, if possible, serve from
+the cache.
+
+For example, `docker pull mirror.kontain.me/busybox` will pull and cache
+`busybox` from Dockerhub. Only public images are supported.
+
+This acts as a simple [registry
+mirror](https://docs.docker.com/registry/recipes/mirror/) which can reduce the
+number of pulls from the original registry, in case they impose request limits
+or exorbitant bandwidth costs or latencies.

cmd/random/README.md

@@ -0,0 +1,10 @@
+# `random.kontain.me`
+
+`docker pull random.kontain.me/random:latest` serves an image containing random
+data.
+
+By default the image contains one layer containing 10 MB of random bytes.
+You can request a specific size and shape of random image.
+
+For example, `random.kontain.me/random:4x100` generates a random image of 4
+layers of 100 random bytes each.