Ansible Role: docker

Role to install (by default) docker package or uninstall (if passed as var) on Ubuntu, Debian and CentOS systems.

Requirements

None.

Role Variables

Available variables are listed below (located in defaults/main.yml):

Variables List:

docker_architecture_map:
  amd64: amd64
  x86_64: amd64
  armv6l: armhfv6
  armv7l: armhfv6
  aarch64: arm64
  32-bit: "386"
  64-bit: amd64
docker_apps:
  - docker-ce
  - docker-ce-cli
  - containerd.io
docker_apps_desired_state: present
docker_service_name: docker
docker_service_desired_state: restarted
docker_service_desired_boot_enabled: yes
docker_group: docker
docker_group_desired_state: present
docker_user: docker
docker_user_home: "/home/{{ docker_user }}"
docker_user_shell: /bin/bash
docker_user_desired_state: present
docker_repo_gpg_key: https://download.docker.com/linux/{{ ansible_distribution | lower }}/gpg
docker_nonroot_users:
  - darkwizard242
  - ubuntu
docker_add_nonroot_users: false
docker_centos_pre_reqs:
  - device-mapper-persistent-data
  - lvm2
docker_centos_pre_reqs_desired_state: present
docker_repo_centos: https://download.docker.com/linux/centos/7/$basearch/stable
docker_repo_centos_gpg_key: https://download.docker.com/linux/centos/gpg
docker_repo_centos_name: docker-ce-stable
docker_repo_centos_description: Docker CE Stable - $basearch
docker_repo_centos_gpgcheck: yes
docker_repo_centos_enabled: yes
docker_repo_centos_filename: docker-ce
docker_repo_centos_desired_state: present
docker_debian_pre_reqs:
  - apt-transport-https
  - ca-certificates
  - curl
  - gnupg
  - lsb-release
docker_debian_pre_reqs_desired_state: present
docker_repo_debian: "deb [arch={{ ansible_architecture }}] https://download.docker.com/linux/debian {{ ansible_lsb['codename'] }} stable"
docker_repo_debian_filename: docker-ce
docker_repo_debian_desired_state: present

Variables table:

Dependencies

None

Example Playbook

For default behaviour of role (i.e. installation of docker package) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.docker

For customizing behavior of role (i.e. adding a list of users to be added to docker group - example shown below is adding ubuntu && darkwizard to docker group) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.docker
  vars:
    docker_add_nonroot_users: true
    docker_nonroot_users:
      - darkwizard242
      - ubuntu

For customizing behavior of role (i.e. skipping the task that adds a list of users to be added to docker group) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.docker
  vars:
    docker_add_nonroot_users: false

For customizing behavior of role (i.e. un-installation of docker-ce, docker-ce-cli, containerd.io packages) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.docker
  vars:
    docker_apps_desired_state: absent

License

MIT

Author Information

This role was created by Ali Muhammad.