ateoto / ansible-role-docker

Ansible role for installing Docker

ansible-role-docker

This is a reusable role to deploy docker using ansible.

Tested against Ubuntu LTS and Debian stable, as of 2015-08-24 the role has been updated to reflect changes in Docker repo, installing docker-engine.

Installation

ansible-galaxy install ateoto.docker

Usage

If you specify a docker_auth and docker_email variable, this role will generate a config.json file for you. The docker_auth string is a base64 encoded string in the format of DockerHubUsername:DockerHubPassword. To generate this you can either login to DockerHub locally and grab the auth string from ~/.docker/config.json or you can use bash or a programming language of some kind.

Example in bash:

$ echo ateoto:t3rriblepass | base64 -i -
YXRlb3RvOnQzcnJpYmxlcGFzcwo=

Roadmap

• Support for all Debian/Ubuntu platforms
• Support for installing other Docker components (machine/swarm)

ansible-role-docker's Issues

Failing tasks

When running the role I can the following errors:

TASK: [ateoto.docker | filesystems] *******************************************
failed: [my-server] => {"changed": true, "cmd": ["grep", "-q", "aufs", "/proc/filesystems"], "delta": "0:00:00.002132", "end": "2015-08-25 09:12:56.191350", "rc": 1, "start": "2015-08-25 09:12:56.189218", "warnings": []}
...ignoring

TASK: [ateoto.docker | modprobe] **********************************************
failed: [my-server] => {"changed": true, "cmd": ["modprobe", "aufs"], "delta": "0:00:00.002233", "end": "2015-08-25 09:12:56.575039", "rc": 1, "start": "2015-08-25 09:12:56.572806", "warnings": []}
stderr: modprobe: ERROR: ../libkmod/libkmod.c:556 kmod_search_moddep() could not open moddep file '/lib/modules/4.1.0-x86_64-linode59/modules.dep.bin'
...ignoring

TASK: [ateoto.docker | Add kernel extras for AUFS] ****************************
failed: [my-server] => (item=linux-image-extra-4.1.0-x86_64-linode59,linux-image-extra-virtual) => {"failed": true, "item": "linux-image-extra-4.1.0-x86_64-linode59,linux-image-extra-virtual"}
msg: No package matching 'linux-image-extra-4.1.0-x86_64-linode59' is available

I'm running it on a Ubuntu 14.04.3 LTS machine (trusty).

Update Docs to reflect merged changes

PR's merged, but need to document changes and new options.

Make it possible to specify which docker-engine version to use

As far as I can see the latest version is always installed