Role Name

This role is for installing Docker on managed hosts. It is based on angstwad.docker with a few changes:

• No longer supports Ubuntu 12.04
• Allows you to install a specific version of Docker and includes a package fix to prevent version updates
• Currently does not manage UFW (Uncomplicated Firewall)

Requirements

Needs python-pycurl for the apt modules to work.

Role Variables

These are the default settings. You can change them to avoid restarting if the latest linux-image-extra and cgroup-lite packages are already installed. Here are the defined variables:

---
# defaults file for ansible-role-docker
# docker-engine is the default package name
docker_pkg_name: docker-engine
docker_pkg_version: latest
docker_apt_cache_valid_time: 600

# Docker DNS path for the docker.io package (changed to docker.io in Ubuntu 14.04)
docker_defaults_file_path: /etc/default/docker

# URL to get the apt repository key
apt_key_url: hkp://p80.pool.sks-keyservers.net:80
# Signature of the apt repository key
apt_key_sig: 58118E89F3A912897C070ADBF76221572C52609D
# Name of the apt repository for Docker
apt_repository: deb https://apt.dockerproject.org/repo ubuntu-{{ ansible_distribution_release }} main
# Options to expose a Docker port or add other settings
# The default is not to use any special options.
docker_opts: ""
# List of users to add to the 'docker' system group (disabled by default)
# SECURITY WARNING:
# Be cautious; users in this group can gain full root access to the Docker host system!
docker_group_members: []
# Settings to install pip packages
pip_install_pip: true
pip_install_setuptools: true
pip_install_docker_py: true
pip_install_docker_compose: true
# Versions of the Python packages to install
pip_version_pip: latest
pip_version_setuptools: latest
pip_version_docker_py: latest
pip_version_docker_compose: latest

# Set to 'yes' or 'true' to enable updates (uses 'latest' for apt module)
# Set to 'no' or 'false' to fix the version (uses specific docker_version and installs package fix)
update_docker_package: no

Dependencies

None required.

Testing

To test this role in a Vagrant environment, run vagrant up. This will create a virtual machine based on Ubuntu 14.04 and set it up using this role with Ansible.

Make sure ansible-playbook is in your path.

License

Apache v2.0