zuul-jobs/roles/install-docker/README.rst
Monty Taylor 899bd89833
Add role for installing docker and configuring registry mirror
There are two different ways to install docker - from upstream repos or
from distro. At the moment each of these carries with it the need for a
different caching proxy setup.

Add a role that will install docker from upstream by default, but which
also supports installing directly from distros. The role also sets up
the registry proxy appropriately for each.

This role at the moment only works on ubuntu. It should obviously be
updated to work on centos and fedora as well.

Needed-By: https://review.openstack.org/580160
Change-Id: I7d6bac68a2c0fecf13a8bd9535a3fdeb85e7d999
2018-07-15 13:06:36 -05:00

27 lines
794 B
ReStructuredText

An ansible role to install docker and configure it to use mirrors if available.
**Role Variables**
.. zuul:rolevar:: mirror_fqdn
:default: {{ zuul_site_mirror_fqdn }}
The base host for mirror servers.
.. zuul:rolevar:: docker_mirror
URL to override the generated docker hub mirror url based on
:zuul:rolevar:`install-docker.mirror_fqdn`.
.. zuul:rolevar:: use_upstream_docker
:default: True
By default this role adds repositories to install docker from upstream
docker. Set this to False to use the docker that comes with the distro.
.. zuul:rolevar:: docker_update_channel
:default: stable
Which update channel to use for upstream docker. The two choices are
``stable``, which is the default and updates quarterly, and ``edge``
which updates monthly.