Mirrors/geerlingguy.ansible-role-docker
1
0
Fork 0
mirror of https://github.com/geerlingguy/ansible-role-docker.git synced 2024-11-18 19:10:43 +01:00
Code Issues Projects Releases Wiki Activity
Ansible Role - Docker
35 Commits 3 Branches 63 Tags 1.2 MiB
7f9f052be4
Go to file
Joseph Benden 7f9f052be4 Ubuntu 16.04 LTS requires dmsetup for Docker to install 
Docker may hang during installation when the `dmsetup` package
is not installed on Ubuntu 16.04. For more information, see the
Docker bug report docker/docker#23347
2017-08-05 14:46:58 -07:00
defaults Merge pull request #16 from digmore/armhf-support 2017-07-31 22:00:11 -05:00
handlers Initial commit. 2017-02-23 22:08:18 -06:00
meta Initial commit. 2017-02-23 22:08:18 -06:00
tasks Ubuntu 16.04 LTS requires dmsetup for Docker to install 2017-08-05 14:46:58 -07:00
tests Update test script README. [ci skip] 2017-04-02 10:40:37 -05:00
.gitignore Switch to more efficient and compact test setup. 2017-04-01 22:48:28 -05:00
.travis.yml Add ubuntu1404 to .travis.yml 2017-05-24 02:30:19 +03:00
LICENSE Add a LICENSE file for MIT license. [ci skip] 2017-03-31 11:23:23 -05:00
README.md Merge pull request #16 from digmore/armhf-support 2017-07-31 22:00:11 -05:00

README.md

Ansible Role: Docker

Build Status

An Ansible Role that installs Docker on Linux.

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

# Edition can be one of: 'ce' (Community Edition) or 'ee' (Enterprise Edition).
docker_edition: 'ce'
docker_package: "docker-{{ docker_edition }}"
docker_package_state: present

The docker_edition should be either ce (Community Edition) or ee (Enterprise Edition). You can also specify a specific version of Docker to install using a format like docker-{{ docker_edition }}-<VERSION>. And you can control whether the package is installed, uninstalled, or at the latest version by setting docker_package_state to present, absent, or latest, respectively.

docker_install_compose: true
docker_compose_version: "1.13.0"
docker_compose_path: /usr/local/bin/docker-compose

Docker Compose installation options.

docker_apt_release_channel: stable
docker_apt_repository: "deb https://download.docker.com/linux/{{ ansible_distribution|lower }} {{ ansible_distribution_release }} {{ docker_apt_release_channel }}"

(Used only for Debian/Ubuntu.) You can switch the channel to edge if you want to use the Edge release.

docker_yum_repo_url: https://download.docker.com/linux/centos/docker-{{ docker_edition }}.repo
docker_yum_repo_enable_edge: 0
docker_yum_repo_enable_test: 0

(Used only for RedHat/CentOS.) You can enable the Edge or Test repo by setting the respective vars to 1.

Use with Ansible (and docker Python library)

Many users of this role wish to also use Ansible to then build Docker images and manage Docker containers on the server where Docker is installed. In this case, you can easily add in the docker Python library using the geerlingguy.pip role:

- hosts: all

  vars:
    pip_install_packages:
      - name: docker

  roles:
    - geerlingguy.pip
    - geerlingguy.docker

Dependencies

None.

Example Playbook

- hosts: all
  roles:
    - geerlingguy.docker

License

MIT / BSD

Author Information

This role was created in 2017 by Jeff Geerling, author of Ansible for DevOps.