darkwizard242.docker
Rôle Ansible : docker
Rôle pour installer (par défaut) le paquet docker ou le désinstaller (si passé comme variable) sur les systèmes Ubuntu, Debian et CentOS.
Exigences
Aucune.
Variables du rôle
Les variables disponibles sont énumérées ci-dessous (situées dans defaults/main.yml) :
Liste des variables :
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
Tableau des variables :
| Variable | Description |
|---|---|
| docker_architecture_map | Variable pour les types d'architecture système. |
| docker_apps | Noms des paquets d'applications Docker à installer, c'est-à-dire docker-ce, docker-ce-cli, containerd.io |
| docker_apps_desired_state | État des paquets docker_apps (c'est-à-dire docker-ce, docker-ce-cli, containerd.io). Indique s'il faut installer, vérifier la disponibilité ou désinstaller (c'est-à-dire valeurs du module apt d'ansible : present, latest, ou absent) |
| docker_service_name | Nom de service par défaut pour Docker. |
| docker_service_desired_state | État souhaité pour le service Docker. |
| docker_service_desired_boot_enabled | État désiré activé/désactivé pour le service Docker. |
| docker_group | Nom du groupe auquel appartiendra le propriétaire de Docker. Tout utilisateur nécessitant d'utiliser l'application Docker doit être membre du groupe docker. |
| docker_group_desired_state | present indique de créer le groupe s'il n'existe pas. L'alternative est absent. |
| docker_user | Nom de l'utilisateur qui possédera Docker. |
| docker_user_home | Répertoire personnel pour l'utilisateur Docker. |
| docker_user_shell | Shell pour docker_user. |
| docker_user_desired_state | present indique la création de l'utilisateur s'il n'existe pas. L'alternative est absent. |
| docker_nonroot_users | Liste des utilisateurs à ajouter au groupe docker |
| docker_add_nonroot_users | Variable booléenne. Les valeurs peuvent être true ou false. Si définie sur true, la tâche ajoutant des utilisateurs fournis dans la variable docker_nonroot_users au groupe docker sera exécutée. Si définie sur false, cette tâche sera ignorée. Valeur par défaut : false |
| docker_repo_gpg_key | Clé GPG du dépôt Docker |
| docker_centos_pre_reqs | Docker recommande l'installation de ces deux paquets sur le système hôte EL/CentOS et ils sont considérés comme des prérequis. |
| docker_centos_pre_reqs_desired_state | État souhaité pour les applications pré-requises Docker sur les systèmes EL/CentOS. |
| docker_repo_centos | URL de base du dépôt pour Docker sur les systèmes basés sur EL/CentOS. |
| docker_repo_centos_name | Nom du dépôt pour Docker sur les systèmes basés sur EL/CentOS. |
| docker_repo_centos_description | Description à ajouter dans le fichier de dépôt EL/CentOS pour Docker. |
| docker_repo_centos_gpgcheck | Booléen pour savoir s'il faut effectuer une vérification gpg sur Docker sur les systèmes basés sur EL/CentOS. |
| docker_repo_centos_enabled | Booléen pour activer le dépôt Docker sur les systèmes basés sur EL/CentOS. |
| docker_repo_centos_filename | Nom du fichier de dépôt qui sera stocké dans /yum/sources.list.d/docker-ce.repo sur les systèmes basés sur EL/CentOS. |
| docker_repo_centos_desired_state | present indique de créer le fichier de dépôt s'il n'existe pas sur les systèmes basés sur EL/CentOS. L'alternative est absent (non recommandé car cela empêche l'installation des paquets docker). |
| docker_debian_pre_reqs_desired_state | État souhaité pour les applications pré-requises Docker sur les systèmes de la famille Debian. |
| docker_repo_debian | URL du dépôt Docker pour les systèmes Debian. Utilise des faits comme ansible_architecture. |
| docker_repo_debian_filename | Nom du fichier de dépôt qui sera stocké dans /etc/apt/sources.list.d/ sur les systèmes basés sur Debian. |
| docker_repo_debian_desired_state | present indique de créer le fichier de dépôt s'il n'existe pas sur les systèmes basés sur Debian. L'alternative est absent (non recommandé car cela empêche l'installation des paquets docker). |
Dépendances
Aucune.
Exemple de Playbook
Pour le comportement par défaut du rôle (c'est-à-dire l'installation du paquet docker) dans les playbooks Ansible.
- hosts: servers
roles:
- darkwizard242.docker
Pour personnaliser le comportement du rôle (c'est-à-dire ajouter une liste d'utilisateurs au groupe Docker - exemple ci-dessous ajoutant ubuntu et darkwizard au groupe docker) dans les playbooks Ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_add_nonroot_users: true
docker_nonroot_users:
- darkwizard242
- ubuntu
Pour personnaliser le comportement du rôle (c'est-à-dire ignorer la tâche qui ajoute une liste d'utilisateurs au groupe docker) dans les playbooks Ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_add_nonroot_users: false
Pour personnaliser le comportement du rôle (c'est-à-dire désinstaller les paquets docker-ce, docker-ce-cli, containerd.io) dans les playbooks Ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_apps_desired_state: absent
Licence
Informations sur l'auteur
Ce rôle a été créé par Ali Muhammad.
À propos du projet
Docker-ce stable version installation/uninstallation.
Installer
ansible-galaxy install darkwizard242.dockerLicence
mit
Téléchargements
4.9k
Propriétaire
Senior DevOps/CloudOps Engineer.
Dedicated to Automating everything I come across.
Love to work on and learn new technologies/tools everyday!