Docker Registry Ansible role

An Ansible role for ensuring the configuration of a docker registry.

If registry_deploy_via is set to kubernetes (The default.):

• If registry is set to yes (The default.), a private registry is spun up on registry_port (5000 is the default.) on a private IP (192.168.0.200 is the default.)
• If passthrough_regsitry is set to yes (The default is no.), a passthrough registry is spun up on on passthrough_registry_port (5000 is the default.) of a private IP (192.168.0.201 is the default.)

If registry_deploy_via is set to docker-compose:

• If registry is set to yes (The default.), a private registry is spun up on registry_port (5000 is the default.) of the host
• If passthrough_regsitry is set to yes (The default is no.), a passthrough registry is spun up on on passthrough_registry_port (5001 is the default.) of the host

Requirements

Requires Kubernetes and MetalLB installed, when registry_deploy_via is set to kubernetes. Otherwise, requires Docker and Docker Compose, when registry_deploy_via is set to docker-compose..

Role Variables

Variable	Required	Default	Choices	Comments
docker_timeout	yes	300	Integer value	Number of seconds before docker pull timeout
docker_retries	yes	60	Integer value	Number of tries for docker pull
docker_delay	yes	10	Integer value	Delay in seconds between pull retries
default_retries	yes	60	Integer value	Default number of retries
default_delay	yes	60	Integer value	Default delay in seconds between retries
registry_version	yes	2.7.1	matches tag	Docker registry version
registry	no	yes	yes or no	spin up a private regsitry
registry_host	yes	not defined	IP address	IP address if deployed via Kubernetes otherwise use the IP of the host
registry_port	yes	5000	Integer	Port for the registry
passthrough_registry	no	yes	yes or no	Also, create a passthrough registry
passthrough_registry_host	no	not defined	IP address	IP address if deployed via Kubernetes otherwise use the IP of the host
passthrough_registry_port	no	5000 or 5001	Integer value	Port for passthrough registry. 5001, if via docker-compose. Otherwise 5000, if Kuberenetes
registry_deploy_via	no	kubernetes	kubernetes or docker-compose	How to spin up
images_cache_path	no	not defined	Path	Path to folder used to cache saved Docker images

Example Playbook

An example can be found used in my Hands-on DevOps course's ansible/master-playbook.yml.

- hosts: masters
  remote_user: vagrant
  roles:
    - common
    - docker
    - docker-compose
    - docker-registry

The above Ansible playbook uses my

• Common role to configure the instance past the base CentOS 7, Alpine 3.10 or Ubuntu Bionic image
• Docker role to install and configure Docker
• Docker-compose role to install Docker-compose
• Docker Registry role to install a private Docker registry

For more information and to see this role put into action checkout my Hands-on DevOps class project.

License

3-Clause BSD License

Author Information

Michael Joseph Walsh [email protected]