distribution-fips

The goal of this project is to provide a simple, secure, and scalable base for building a large scale registry solution or running a simple private registry.

Download this Image

The image is available on cgr.dev:

docker pull cgr.dev/chainguard/distribution:latest

Usage

There are various ways to run the distribution image, the simplest way of running the distribution image is to use the following command:

$ docker run -d -p 5000:5000 --restart=always --name registry cgr.dev/chainguard/distribution:latest

For more information about deploying the registry, you can check the official documentation.

Then you should be able to access the registry on http://localhost:5000.

In order to push and pull images from the registry, you may want to use crane tool which is a tool for interacting with container registries.

In case you want to test the registry with crane, you can use the following commands:

crane copy alpine:latest localhost:5000/alpine:latest

and check for the tags for the alpine image:

$ crane ls localhost:5000/alpine
latest

In case you want to deploy it on Kubernetes, you can use the following Helm chart: https://distribution.github.io/distribution/about/deploying/

helm repo add twuni https://helm.twun.io
helm repo update

You can then install the chart with the following command:

helm install registry twuni/docker-registry \
   --set image.tag=latest \
   --set image.repository=cgr.dev/chainguard/distribution