Rôle Ansible : Docker pour ARM

Obsolète : Veuillez utiliser geerlingguy.docker à la place. Sur les distributions modernes, Docker devrait s'installer sans problème sur ARM ou X86 (voire même RISC-V !) en utilisant ce rôle.

Un rôle Ansible qui installe Docker sur Linux, spécialement conçu pour les ordinateurs basés sur ARM comme le Raspberry Pi.

Utilisation du rôle dans des projets réels

En plus de la documentation ici, veuillez consulter le Raspberry Pi Dramble pour un exemple de ce rôle en action, utilisé avec plusieurs Raspberry Pi pour construire un cluster Kubernetes, ou Drupal Pi pour un exemple d'utilisation avec un seul Raspberry Pi.

Exigences

Si vous installez Docker Compose, Python Pip doit déjà être installé (vous pouvez utiliser geerlingguy.pip pour l'installer).

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec des valeurs par défaut (voir defaults/main.yml) :

docker_version: latest

La version de Docker à installer. Vous pouvez spécifier une version exacte pour la verrouiller (vérifiez les versions disponibles avec apt-cache madison docker-ce).

docker_install_recommends: false

Indique si des paquets recommandés doivent être installés en même temps que docker-ce.

docker_install_compose: true

Indique si Docker Compose doit être installé via Pip.

docker_users:
  - user1
  - user2

Une liste d'utilisateurs du système à ajouter au groupe docker (afin qu'ils puissent utiliser Docker sur le serveur).

docker_pip_executable: pip3

Réglez ceci sur pip pour Python 2 ou pip3 pour Python 3.

Utilisation avec Ansible (et la bibliothèque Python docker)

De nombreux utilisateurs de ce rôle souhaitent également utiliser Ansible pour ensuite construire des images Docker et gérer des conteneurs Docker sur le serveur où Docker est installé. Dans ce cas, vous pouvez facilement ajouter la bibliothèque Python docker en utilisant le rôle geerlingguy.pip :

- hosts: rpi

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

  roles:
    - geerlingguy.pip
    - geerlingguy.docker_arm

Dépendances

Aucune.

Exemple de Playbook

- hosts: rpi

  vars:
    pip_package: python3-pip

  roles:
    - geerlingguy.pip
    - geerlingguy.docker_arm

Licence

MIT / BSD

Informations sur l'auteur

Ce rôle a été créé en 2019 par Jeff Geerling, auteur de Ansible for DevOps.