README.md

Ansible Docker Role

Dependencies

• Ansible >= 2.7
• pyOpenSSL

Setup

• Install ansible and dependencies by running pip install -r requirements.txt.

• Add this role to your playbook requirements.yml:

- src: https://github.com/5monkeys/ansible-docker-role
  name: docker

• Update ansible.cfg to search for roles relative to playbook:

roles_path = ./roles

• Install playbook dependencies by running ansible-galaxy install -r requirements.yml.

Variables

# What docker version to be installed (18.06, 5:18.09). Default is latest.
docker_ce_version:

# If linux-image-extra packages should be installed. Needed for the AUFS storage driver.
docker_install_kernel_extras: false
# Where to download TLS-certificates
docker_home: ".docker"
# Maps to docker -H
docker_hosts:
  - "unix://"
  - "tcp://0.0.0.0:2376"
# What docker storage driver to use
docker_storage_driver: "overlay2"
# What version of the docker python library to use
docker_python_version: "4.0.1"

# If TLS should be enabled on the docker daemon and SSL-certificates generated
docker_use_tls: true
# What to set as Organization in SSL-certificates
docker_tls_organization: "Acme"
# Where to place certificates on host
docker_tls_path: "/etc/docker/certs"
# When the client certificate should expire. 
docker_tls_client_expires_after: "+52w"
# The client certificate common name
docker_tls_client_common_name: "client"

# If a docker swarm manager node should be initialized on the host
docker_enable_swarm: true
# What version of the python openssl library to use
docker_py_openssl_version: "19.0.0"

Example playbook

- name: Setup docker
  hosts: managers
  become: true
  become_user: root
  roles:
    - docker
  vars:
    docker_home: "{{ inventory_dir }}/.certs/"
    docker_tls_organization: "my_org"
    docker_ce_version: "18.06"