Ansible Role for Installing or Updating Docker-Compose

This role:

• Installs or updates docker-compose from the GitHub releases of Docker.

Requirements

You need Docker installed. Check out the ansible docker role for help.

Role Variables

(required) docker_compose_version: This specifies the version of docker-compose you want. You can also use latest to get the most recent version from GitHub.

(optional) docker_compose_bin: This specifies where to install docker-compose. The default is /usr/local/bin/docker-compose.

(optional) docker_compose_as_root: This determines if you want to use sudo for installation. The default is yes.

Dependencies

No special dependencies needed.

Example Playbook

To install the role globally, run:

ansible-galaxy install Bessonov.docker-compose

Or to install it locally, you can use:

ansible-galaxy install --roles-path roles Bessonov.docker-compose

Here’s an example playbook:

- hosts: servers
  roles:
     - Bessonov.docker-compose

Or you can specify parameters:

- hosts: servers
  roles:
     - role: Bessonov.docker-compose
       # required: your desired version or 'latest'
       docker_compose_version: 1.16.0
       # optional: where to install it
       docker_compose_bin: /usr/local/bin/docker-compose
       # optional: whether to install as root
       docker_compose_as_root: yes

License

The MIT License (MIT)

Copyright (c) 2016, Anton Bessonov

You are allowed to use, copy, modify, and distribute this software freely, as long as you include the original copyright notice and this permission notice in any copies or substantial parts of the software.

The software is provided "as is", without any warranty, so the authors are not responsible for any issues that arise from using it.