Ansible Role for Installing or Updating Docker Engine

This role does the following:

• Imports the apt-key from the Docker project.
• Installs or updates the Docker engine.
• Restarts the Docker engine.

Check out:

• Ansible Docker-Compose Role
• Ansible Docker-Swarm Role.

Requirements

No special requirements needed.

Role Variables

(Optional) docker_engine_version allows you to specify the Docker engine version. You can also downgrade, but note that Docker may not work correctly when you do this.

(Optional) docker_engine_allow_non_root lets you specify a list of users to add to the docker group for non-root access. Users will need to log back in or use newgrp docker to activate it for their current session. Be careful, as this can create a security risk similar to giving root access.

Dependencies

No dependencies required.

Example Playbook

To install the role globally, run:

ansible-galaxy install Bessonov.docker

Or install it locally:

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

Here’s an example playbook:

- hosts: servers
  roles:
     - Bessonov.docker

Or, if you want to set parameters:

- hosts: servers
  roles:
     - role: Bessonov.docker
       # Optional: set Docker version
       docker_engine_version: 17.06.2

License

MIT License (MIT)

Copyright (c) 2016, Anton Bessonov

You can use, copy, modify, and share this software for free. Just make sure to include the copyright and permission notice in your copies. The software is offered "as is," meaning there are no guarantees it will work correctly, and the authors are not responsible for any problems that arise from using it.