ansible-role-container-regi.../README.rst

88 lines
2.0 KiB
ReStructuredText

ansible-role-container-registry
===============================
A role to deploy a container registry.
For now, the role only support Docker Registry v2.
Role Variables
--------------
.. list-table:: Variables used for container registry
:widths: auto
:header-rows: 1
* - Name
- Default Value
- Description
* - `container_registry_debug`
- `false`
- Enable debug option in Docker
* - `container_registry_deploy_docker`
- `true`
- Whether or not to deploy Docker
* - `container_registry_deploy_docker_distribution`
- `true`
- Whether or not to deploy Docker Distribution
* - `container_registry_deployment_user`
- `centos`
- User which needs to manage containers
* - `container_registry_docker_options`
- `--log-driver=journald --signature-verification=false --iptables=false --live-restore`
- Options given to Docker configuration
* - `container_registry_insecure_registries`
- `[]`
- Array of insecure registries
* - `container_registry_network_options`
- `[undefined]`
- Docker networking options
* - `container_registry_host`
- `localhost`
- Docker registry host
* - `container_registry_port`
- `8787`
- Docker registry port
* - `container_registry_mirror`
- `[undefined]`
- Docker registry mirror
* - `container_registry_storage_options`
- `-s overlay2`
- Docker storage options
* - `container_registry_selinux`
- `false`
- Whether or not SElinux is enabled for containers
* - `container_registry_additional_sockets`
- `[undefined]`
- Additional sockets for containers
Requirements
------------
- ansible >= 2.4
- python >= 2.6
Dependencies
------------
None
Example Playbooks
-----------------
Modify Image
~~~~~~~~~~~~
The following playbook will deploy a Docker registry:
.. code-block::
- hosts: localhost
become: true
roles:
- container-registry
License
-------
Apache 2.0