/ansible-collection-docker

An ansible collection for container related things

Ansible Collection - mafalb.docker Build Status

Basic Usage

- hosts: localhost
  roles:
    - role: mafalb.docker/docker

to install the distribution provided docker daemon

or

- hosts: localhost
  roles:
    - role: mafalb.docker/docker
      docker_package: docker-ce

to install docker-ce provided by Docker Inc.

or

hosts: localhost
  roles:
    - role: mafalb.docker/python

to install the Docker SDK for Python. For instance, this is a requirement for ansible nodes if you use docker_image or docker_container.

Variables

With many distributions you have a choice which docker you want. Some distributions ship with docker packages, but you could choose to not install the distribution provided docker. Sometimes the distribution docker seems too outdated, or maybe docker is preinstalled in a CI environment). My docker module supports the docker-ce packages provided by Docker Inc. as an alternative, docker-ee is not supported.

if your distribution does provide docker, and you want to install docker-ce, you have to set this variable.
if your distribution does not provide docker, you don't have to set this variable. There is only one choice anyways.

docker_package: docker-ce # set this if you want to install docker-ce from Docker Inc.

Author

This ansible collection was created by Markus Falb

License

GPLv3