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

This role will setup and configure a docker installation
https://github.com/5monkeys/ansible-docker-role

ansible ansible-role docker

Last synced: 3 months ago
JSON representation

This role will setup and configure a docker installation

• Host: GitHub
• URL: https://github.com/5monkeys/ansible-docker-role
• Owner: 5monkeys
• Created: 2016-10-05T13:31:37.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-09-23T23:23:38.000Z (over 3 years ago)
• Last Synced: 2023-03-22T17:23:00.267Z (almost 2 years ago)
• Topics: ansible, ansible-role, docker
• Language: Python
• Homepage:
• Size: 65.4 KB
• Stars: 1
• Watchers: 11
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Ansible Docker Role

[![Build Status](https://travis-ci.com/5monkeys/ansible-docker-role.svg?branch=role-refactor)](https://travis-ci.com/5monkeys/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:

```yaml

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

  name: docker

``` 

* Update `ansible.cfg` to search for roles relative to playbook:

```ini

roles_path = ./roles

```

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

## Variables

```yaml

# 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

```yaml

- 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"

```