Ansible Role: Docker for ARM

Deprecated: Please use geerlingguy.docker instead. Docker can now be easily installed on ARM or X86 (and even RISC-V!) using that role on modern distributions.

This is an Ansible Role that installs Docker on Linux, specifically designed for ARM devices like the Raspberry Pi.

How to Use the Role in Projects

For examples of how to use this role, check out the Raspberry Pi Dramble, which shows the role in action with several Raspberry Pis to create a Kubernetes cluster. You can also look at Drupal Pi for a single Raspberry Pi example.

Requirements

If you want to install Docker Compose, you'll need Python Pip installed first (you can use geerlingguy.pip to set it up).

Role Variables

Here are the available variables with their default values (see defaults/main.yml):

• docker_version: latest
  The version of Docker you want to install. You can lock it to a specific version (check available versions with apt-cache madison docker-ce).

• docker_install_recommends: false
  Decide if you want to install recommended packages with docker-ce.

• docker_install_compose: true
  Choose whether to install Docker Compose using Pip.

• docker_users:

  - user1
  - user2
  

  A list of system users to add to the docker group so they can use Docker on the server.

• docker_pip_executable: pip3
  Set this to pip for Python 2 or pip3 for Python 3.

Using with Ansible (and docker Python library)

If you also want to use Ansible to build Docker images and manage Docker containers on the server where Docker is installed, you can add the docker Python library with the geerlingguy.pip role:

- hosts: rpi

  vars:
    pip_package: python3-pip
    pip_install_packages:
      - name: docker

  roles:
    - geerlingguy.pip
    - geerlingguy.docker_arm

Dependencies

None.

Example Playbook

- hosts: rpi

  vars:
    pip_package: python3-pip

  roles:
    - geerlingguy.pip
    - geerlingguy.docker_arm

License

MIT / BSD

Author Information

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