Ce rôle est chargé d’installer docker-ce. Les dépôts officiels de docker doivent être présents pour utiliser ce rôle.

Il configure aussi le mode swarm à travers plusieurs hôtes et mets en place un registre local pour servir les images.

Tags internes

  • packages : Installation et configuration des packages ;
  • docker : Configuration du service ;
  • docker-swarm : Configuration du cluster ;

Variables à fournir

Variable Type Requis Défaut Description
docker Objet docker Non Absent Configuration docker
docker_configuration Dictionnaire Non Absent Configuration du service docker
docker_plugins Liste d’objets plugin Non Absent Plugins à installer et activer
docker_swarm Objet swarm Non Absent Configuration du cluster

Type docker

Propriété Type Requis Défaut Description
port Entier entre 1 et 65535 Non 2376 Port d’écoute TCP
name Nom de domaine Non ansible_host Nom du serveur pour le certificat
platforms Liste d’architectures *1 Non Absent Architectures de construction prises en charge

Notes :

  1. Voir https://docs.docker.com/build/building/multi-platform/#qemu pour l’explication et les valeurs valides.

Type plugin

Propriété Type Requis Défaut Description
alias Identifiant Oui Nom local du plugin, en cas de multi-instance
name Chaîne de caractères Oui Nom du plugin à installer
options Dictionnaire de chaînes Oui Options à définir, clé et valeurs chaîne

Type swarm

La configuration ne doit être présente que sur un des nœuds. Pas forcément l’un de ceux de gestion mais conseillé. L’ensemble des nœuds doivent être accessible pendant l’exécution. Attention aux nœuds qui faisaient parti d’un autre cluster. Une opération manuelle pourrait être nécessaire.

Propriété Type Requis Défaut Description
nodes Liste de node Oui Liste des nœuds intégrant le cluster
registry Objet registry Oui Configuration du registre local

Type node

Aux moins un nœud doit être gestionnaire.

Propriété Type Requis Défaut Description
host Identifiant Oui Nom dans l’inventaire du nœud
manager Booléen Non Faux Indique si le nœud est de gestion ou de travail
labels Dictionnaire Non Vide Étiquettes à effecter au nœud

Type registry

Propriété Type Requis Défaut Description
name Identifiant Oui Nom du conteneur
host Identifiant Oui Nœud sur lequel placer le service
domain FQDN Oui Nom de domaine associé