Local Registry 🔗︎

With kind v0.6.0 there is a new config feature containerdConfigPatches that can be leveraged to configure insecure registries. The following recipe leverages this to enable a local registry.

Create A Cluster And Registry 🔗︎

The following shell script will create a local docker registry and a kind cluster with it enabled.

set -o errexit

# desired cluster name; default is "kind"

# create registry container unless it already exists
running="$(docker inspect -f '{{.State.Running}}' "${reg_name}" 2>/dev/null || true)"
if [ "${running}" != 'true' ]; then
  docker run \
    -d --restart=always -p "${reg_port}:5000" --name "${reg_name}" \
reg_ip="$(docker inspect -f '{{.NetworkSettings.IPAddress}}' "${reg_name}")"

# create a cluster with the local registry enabled in containerd
cat <<EOF | kind create cluster --name "${KIND_CLUSTER_NAME}" --config=-
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
- |-
    endpoint = ["http://${reg_ip}:${reg_port}"]

Using The Registry 🔗︎

The registry can be used like this.

  1. First we'll pull an image docker pull gcr.io/google-samples/hello-app:1.0
  2. Then we'll tag the image to use the local registry docker tag gcr.io/google-samples/hello-app:1.0 localhost:5000/hello-app:1.0
  3. Then we'll push it to the registry docker push localhost:5000/hello-app:1.0
  4. And now we can use the image kubectl create deployment hello-server --image=localhost:5000/hello-app:1.0

If you build your own image and tag it like localhost:5000/image:foo and then use it in kubernetes as localhost:5000/image:foo.