Docker registry

The repository contains configuration files necessary to run a standalone docker registry backed by an S3 bucket. The implementation is based on docker-compose.

Prerequisites

Docker and docker compose

You should install docker and docker-compose before going any further.

SSL certificates

I recommend using letsencrypt to obtain valid and free SSL certificates for the registry.

Amazon

You need to create and properly configure (policies/users) an S3 bucket. If you want to run the registry on Amazon EC2, you will also need a running instance and an appropriate DNS entries in Route 53.

Repository content

• compose.yml: docker compose configuration file running redis container (registry cache) and the registry itself.
• registry.yml: docker registry configuration file based on official documentation
• env.sh: a script injecting environment variables into registry.yml and compose.yml files to build the final configuration (registry_config.yml and docker_compose.yml files).

Usage howto

In order to run the setup one need to create the following environment variables:

CERTS_PATH=%path to the certificates folder%
AUTH_PATH=%path to the basic auth configuration%
S3_ACCESSKEY=%S3 bucket's access key%
S3_ACCESSSECRET=%S3 bucket's access secret%
REGISTRY_SECRET=%random string used as secret between the registry and the cache%

The command to launch the registry is (inside the sources folder):

./env.sh && docker-compose up -d