Difficulty: Introduction
Estimated Time: 20 minutes

As a developer of containers and Kubernetes solutions, there is often a need to publish and pull containers through a private registry. When we are prototyping or testing it's handy to set up a local registry that just you or a small group can leverage. Kubernetes is ideal for hosting this solution.

The Registry is a stateless, highly scalable server-side application that stores and lets you distribute container images. The Registry is open-source, under the permissive Apache license.

To learn how the registry works, you will build, push and pull a real application with the registry. The application is a Breast Cancer Mitosis Detector provided by IBM. IBM governs 49+ open source projects covering various deep learning models.

Key Features

  • Follows the Docker Registry HTTP API V2
  • Accepts pushed containers
  • Fulfills container requests
  • Images persisted to backing PersistentVolume
  • Easily hosted on Kubernetes

You will learn how:

  • to install a private container image registry on Kubernetes
  • to install a web interface to reveal the contents of the registry
  • to install another private container image registry called Trow.

Generally, there are three ways to interact with container registries.

  1. Public registries like DockerHub, Quay.io, gcr.io,
  2. Private team registries that are within you organization, often hosted by your cloud provider,
  3. Private registries that you or your team may be using on a local or private Kubernetes cluster or namespace.

This tutorial gives you a leg up for leveraging personal and local registries. This is ideal when you are prototyping or rapidly developing and testing a solution locally. Knowing how to quickly setup and use a private container is another technique you can pull out of your Kubernetes toolbox.

With these steps you have learned:

  • ✔ how to install a private container image registry on Kubernetes,
  • ✔ how to install web interface to list the registry contents,
  • ✔ how to install a private container image registry called Trow.



Lost friend and father, Bill Becker. Male Breast Cancer Awareness Week is the third week of October.

For a deeper understanding of these topics and more join
Jonathan Johnson
at various conferences, symposiums, workshops, and meetups.

Software Architectures ★ Speaker ★ Workshop Hosting ★ Kubernetes & Java Specialist

Kubernetes Pipelines: Registries

Step 1 of 7

Your Kubernetes Cluster

For this scenario, Katacoda has just started a fresh Kubernetes cluster for you. Verify that it's ready for your use.

kubectl version --short && \ kubectl get componentstatus && \ kubectl get nodes && \ kubectl cluster-info

The Helm package manager used for installing applications on Kubernetes is also available.

helm version --short

Kubernetes Dashboard

You can administer your cluster with the kubectl CLI tool or use the visual Kubernetes Dashboard. Use this script to access the protected Dashboard.


Kubernetes Dashboard
Cancer Detector