summaryrefslogtreecommitdiff
path: root/roles/docker.ubuntu/README.md
blob: 0c7de612357caeae730f3ebea3db6be436aa20f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
docker_ubuntu
========

Installs Docker on:

* Ubuntu 14.04+
* Debian Jessie (8.5+) and Stretch

This role attempts to make every reasonable effort to follow Docker's official installation instructions for Ubuntu and Debian.  

**Example Play**:

Very basic install utilizing the role defaults:

```
---
- name: Run docker.ubuntu
  hosts: docker
  roles:
    - angstwad.docker_ubuntu
```

Overriding the default configration is done by overriding the role's default variables:

```
- name: Install Docker
  hosts: all
  roles:
    - role: angstwad.docker_ubuntu
      ssh_port: 2222
      kernel_pkg_state: present
```


Requirements
------------

Requires python-pycurl for apt modules.

Role Variables
--------------

Please see [defaults/main.yml](https://github.com/angstwad/docker.ubuntu/blob/master/defaults/main.yml) for a comprehensive list of variables that can be overridden.

Dependencies
------------

None.

Testing
-------

To test the role in a Vagrant environment just run `vagrant up`.  This will
create some VMs:

* Ubuntu 12.04
* Ubuntu 14.04
* Ubuntu 16.04
* Debian Jessie 8.5
* Debian Stretch 9.0

and it will provision them by applying this role with Ansible.

Requires `ansible-playbook` to be in the path.

License
-------

Apache v2.0