Ceci est une ancienne révision du document !
Table des matières
Version : 2023.01
Dernière mise-à-jour : 2023/09/20 14:02
LCF802 - Les Commandes ansible, ansible-playbook et ansible-galaxy
Contenu du Module
- LCF802 - Les Commandes ansible, ansible-playbook et ansible-galaxy
- Contenu du Module
- LAB #1 - Débuter avec Ansible
- 1.1 - La Commande ansible
- LAB #2 - La Commande ansible-playbook
- 2.1 - Playbook Files
- 2.2 - Tasks
- 2.3 - Handlers
- 2.4 - Modules
- 2.4.1 - Modules pour des Paquets
- 2.4.2 - Modules pour des Fichiers
- 2.4.3 - Modules pour le Système
- 2.5 - Inventory Files
- 2.6 - Privilèges
- 2.6.1 - Création de Groupes
- LAB #3 - La Commande ansible-galaxy
- 3.1 - Utiliser des Rôles avec un Play Book
- 3.2 - Ansible Galaxy
LAB #1 - Débuter avec Ansible
1.1 - La Commande ansible
Utilisez la commande ansible pour vérifier si la machine TargetA fonctionne :
trainee@debian11:~$ ansible all -i 10.0.2.52, -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host 10.0.2.52 should use
/usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior
Ansible releases. A future Ansible release will default to using the discovered
platform python for this host. See
https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html
for more information. This feature will be removed in version 2.12. Deprecation
warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
10.0.2.52 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
Important : Cette commande indique à Ansible qu'elle doit exécuter le module indiqué par l'option -m dans tous (all) les serveurs indiqués par l'option -i. La virgule placée après l'adresse IP indique à la commande ansible que la valeur est une adresse IP et non le nom d'un fichier.
Les options de la commande ansible sont :
trainee@debian11:~$ ansible --help
usage: ansible [-h] [--version] [-v] [-b] [--become-method BECOME_METHOD] [--become-user BECOME_USER] [-K] [-i INVENTORY] [--list-hosts] [-l SUBSET] [-P POLL_INTERVAL] [-B SECONDS] [-o] [-t TREE] [-k]
[--private-key PRIVATE_KEY_FILE] [-u REMOTE_USER] [-c CONNECTION] [-T TIMEOUT] [--ssh-common-args SSH_COMMON_ARGS] [--sftp-extra-args SFTP_EXTRA_ARGS] [--scp-extra-args SCP_EXTRA_ARGS]
[--ssh-extra-args SSH_EXTRA_ARGS] [-C] [--syntax-check] [-D] [-e EXTRA_VARS] [--vault-id VAULT_IDS] [--ask-vault-password | --vault-password-file VAULT_PASSWORD_FILES] [-f FORKS]
[-M MODULE_PATH] [--playbook-dir BASEDIR] [-a MODULE_ARGS] [-m MODULE_NAME]
pattern
Define and run a single task 'playbook' against a set of hosts
positional arguments:
pattern host pattern
optional arguments:
--ask-vault-password, --ask-vault-pass
ask for vault password
--list-hosts outputs a list of matching hosts; does not execute anything else
--playbook-dir BASEDIR
Since this tool does not use playbooks, use this as a substitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
--syntax-check perform a syntax check on the playbook, but do not execute it
--vault-id VAULT_IDS the vault identity to use
--vault-password-file VAULT_PASSWORD_FILES, --vault-pass-file VAULT_PASSWORD_FILES
vault password file
--version show program's version number, config file location, configured module search path, module location, executable location and exit
-B SECONDS, --background SECONDS
run asynchronously, failing after X seconds (default=N/A)
-C, --check don't make any changes; instead, try to predict some of the changes that may occur
-D, --diff when changing (small) files and templates, show the differences in those files; works great with --check
-M MODULE_PATH, --module-path MODULE_PATH
prepend colon-separated path(s) to module library (default=~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules)
-P POLL_INTERVAL, --poll POLL_INTERVAL
set the poll interval if using -B (default=15)
-a MODULE_ARGS, --args MODULE_ARGS
module arguments
-e EXTRA_VARS, --extra-vars EXTRA_VARS
set additional variables as key=value or YAML/JSON, if filename prepend with @
-f FORKS, --forks FORKS
specify number of parallel processes to use (default=5)
-h, --help show this help message and exit
-i INVENTORY, --inventory INVENTORY, --inventory-file INVENTORY
specify inventory host path or comma separated host list. --inventory-file is deprecated
-l SUBSET, --limit SUBSET
further limit selected hosts to an additional pattern
-m MODULE_NAME, --module-name MODULE_NAME
module name to execute (default=command)
-o, --one-line condense output
-t TREE, --tree TREE log output to this directory
-v, --verbose verbose mode (-vvv for more, -vvvv to enable connection debugging)
Privilege Escalation Options:
control how and which user you become as on target hosts
--become-method BECOME_METHOD
privilege escalation method to use (default=sudo), use `ansible-doc -t become -l` to list valid choices.
--become-user BECOME_USER
run operations as this user (default=root)
-K, --ask-become-pass
ask for privilege escalation password
-b, --become run operations with become (does not imply password prompting)
Connection Options:
control as whom and how to connect to hosts
--private-key PRIVATE_KEY_FILE, --key-file PRIVATE_KEY_FILE
use this file to authenticate the connection
--scp-extra-args SCP_EXTRA_ARGS
specify extra arguments to pass to scp only (e.g. -l)
--sftp-extra-args SFTP_EXTRA_ARGS
specify extra arguments to pass to sftp only (e.g. -f, -l)
--ssh-common-args SSH_COMMON_ARGS
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
--ssh-extra-args SSH_EXTRA_ARGS
specify extra arguments to pass to ssh only (e.g. -R)
-T TIMEOUT, --timeout TIMEOUT
override the connection timeout in seconds (default=10)
-c CONNECTION, --connection CONNECTION
connection type to use (default=smart)
-k, --ask-pass ask for connection password
-u REMOTE_USER, --user REMOTE_USER
connect as this user (default=None)
Some modules do not make sense in Ad-Hoc (include, meta, etc)
Les quatre machines WebXX mises à votre disposition sont dans le même réseau que la machine debian11 et ont la même configuration ssh et sudo que la machine debian10 :
| Machine | Nom d'hôte | Adresse IP |
|---|---|---|
| Web01 | web01.i2tch.loc | 10.0.2.54 |
| Web02 | web02.i2tch.loc | 10.0.2.55 |
| Web03 | web03.i2tch.loc | 10.0.2.56 |
| Web04 | web04.i2tch.loc | 10.0.2.57 |
Utilisez la commande scp pour copier le fichier authorized_keys de la machine virtuelle ansible vers les machines virtuelles Web01, Web02, Web03 et Web04 :
trainee@debian11:~$ scp .ssh/authorized_keys trainee@10.0.2.54:/home/trainee/.ssh/authorized_keys The authenticity of host '10.0.2.54 (10.0.2.54)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '10.0.2.54' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 trainee@10.0.2.54's password: trainee authorized_keys 100% 846 2.1MB/s 00:00 trainee@debian11:~$ scp .ssh/authorized_keys trainee@10.0.2.55:/home/trainee/.ssh/authorized_keys The authenticity of host '10.0.2.55 (10.0.2.55)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '10.0.2.55' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 trainee@10.0.2.55's password: trainee authorized_keys 100% 846 1.7MB/s 00:00 trainee@debian11:~$ scp .ssh/authorized_keys trainee@10.0.2.56:/home/trainee/.ssh/authorized_keys The authenticity of host '10.0.2.56 (10.0.2.56)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '10.0.2.56' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 trainee@10.0.2.56's password: trainee authorized_keys 100% 846 1.7MB/s 00:00 trainee@debian11:~$ scp .ssh/authorized_keys trainee@10.0.2.57:/home/trainee/.ssh/authorized_keys The authenticity of host '10.0.2.57 (10.0.2.57)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '10.0.2.57' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 trainee@10.0.2.57's password: trainee authorized_keys
Modifier le fichier /etc/hosts dans debian11 :
trainee@debian11:~$ su - Password: fenestros root@debian11:~# vi /etc/hosts root@debian11:~# cat /etc/hosts 127.0.0.1 localhost 10.0.2.46 debian11.ittraining.loc debian11 10.0.2.54 web01.i2tch.loc web01 10.0.2.55 web02.i2tch.loc web02 10.0.2.56 web03.i2tch.loc web03 10.0.2.57 web04.i2tch.loc web04 # The following lines are desirable for IPv6 capable hosts ::1 localhost ip6-localhost ip6-loopback ff02::1 ip6-allnodes ff02::2 ip6-allrouters root@debian11:~# exit logout
Vérifiez que vous pouvez vous connecter aux machines virtuelles Web01, Web02, Web03 et Web04 sans entrer de mot de passe et que la configuration de sudo est correcte :
trainee@debian11:~$ ssh -l trainee web01 The authenticity of host 'web01 (10.0.2.54)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added 'web01' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 Linux web01.i2tch.loc 4.9.0-8-amd64 #1 SMP Debian 4.9.130-2 (2018-10-27) x86_64 The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Last login: Sun Mar 21 08:49:31 2021 from 10.0.2.10 <code> Modifiez le contenu du fichier **/etc/apt/sources.list** : <code> trainee@web01:~$ sudo vi /etc/apt/sources.list trainee@web01:~$ cat /etc/apt/sources.list # # deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main #deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main deb http://archive.debian.org/debian/ stretch main deb-src http://archive.debian.org/debian/ stretch main deb http://archive.debian.org/debian-security stretch/updates main deb-src http://archive.debian.org/debian-security stretch/updates main trainee@web01:~$ sudo apt update Ign:1 http://archive.debian.org/debian stretch InRelease Réception de:2 http://archive.debian.org/debian-security stretch/updates InRelease [59,1 kB] Réception de:3 http://archive.debian.org/debian stretch Release [118 kB] Réception de:4 http://archive.debian.org/debian-security stretch/updates/main Sources [413 kB] Réception de:5 http://archive.debian.org/debian-security stretch/updates/main amd64 Packages [782 kB] Réception de:6 http://archive.debian.org/debian-security stretch/updates/main Translation-en [368 kB] Réception de:7 http://archive.debian.org/debian stretch Release.gpg [3 177 B] Réception de:8 http://archive.debian.org/debian stretch/main Sources [6 736 kB] Réception de:9 http://archive.debian.org/debian stretch/main amd64 Packages [7 080 kB] Réception de:10 http://archive.debian.org/debian stretch/main Translation-en [5 377 kB] Réception de:11 http://archive.debian.org/debian stretch/main Translation-fr [1 894 kB] 22,8 Mo réceptionnés en 24s (949 ko/s) Lecture des listes de paquets... Fait Construction de l'arbre des dépendances Lecture des informations d'état... Fait 358 packages can be upgraded. Run 'apt list --upgradable' to see them. trainee@web01:~$ exit déconnexion Connection to web01 closed.
trainee@debian11:~$ ssh -l trainee web02 The authenticity of host 'web02 (10.0.2.55)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added 'web02' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 Linux web02.i2tch.loc 4.9.0-8-amd64 #1 SMP Debian 4.9.130-2 (2018-10-27) x86_64 The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Last login: Sun Mar 21 08:50:56 2021 from 10.0.2.10
Modifiez le contenu du fichier /etc/apt/sources.list :
trainee@web02:~$ sudo vi /etc/apt/sources.list trainee@web02:~$ cat /etc/apt/sources.list # # deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main #deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main deb http://archive.debian.org/debian/ stretch main deb-src http://archive.debian.org/debian/ stretch main deb http://archive.debian.org/debian-security stretch/updates main deb-src http://archive.debian.org/debian-security stretch/updates main trainee@web02:~$ sudo apt update Ign:1 http://archive.debian.org/debian stretch InRelease Réception de:2 http://archive.debian.org/debian-security stretch/updates InRelease [59,1 kB] Réception de:3 http://archive.debian.org/debian stretch Release [118 kB] Réception de:4 http://archive.debian.org/debian-security stretch/updates/main Sources [413 kB] Réception de:5 http://archive.debian.org/debian-security stretch/updates/main amd64 Packages [782 kB] Réception de:6 http://archive.debian.org/debian-security stretch/updates/main Translation-en [368 kB] Réception de:7 http://archive.debian.org/debian stretch Release.gpg [3 177 B] Réception de:8 http://archive.debian.org/debian stretch/main Sources [6 736 kB] Réception de:9 http://archive.debian.org/debian stretch/main amd64 Packages [7 080 kB] Réception de:10 http://archive.debian.org/debian stretch/main Translation-en [5 377 kB] Réception de:11 http://archive.debian.org/debian stretch/main Translation-fr [1 894 kB] 22,8 Mo réceptionnés en 24s (949 ko/s) Lecture des listes de paquets... Fait Construction de l'arbre des dépendances Lecture des informations d'état... Fait 358 packages can be upgraded. Run 'apt list --upgradable' to see them. trainee@web02:~$ exit déconnexion Connection to web02 closed.
trainee@debian11:~$ ssh -l trainee web03 The authenticity of host 'web03 (10.0.2.56)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added 'web03' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 Linux web03.i2tch.loc 4.9.0-8-amd64 #1 SMP Debian 4.9.130-2 (2018-10-27) x86_64 The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Last login: Sun Mar 21 08:51:51 2021 from 10.0.2.10
Modifiez le contenu du fichier /etc/apt/sources.list :
trainee@web03:~$ sudo vi /etc/apt/sources.list trainee@web03:~$ cat /etc/apt/sources.list # # deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main #deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main deb http://archive.debian.org/debian/ stretch main deb-src http://archive.debian.org/debian/ stretch main deb http://archive.debian.org/debian-security stretch/updates main deb-src http://archive.debian.org/debian-security stretch/updates main trainee@web03:~$ sudo apt update Ign:1 http://archive.debian.org/debian stretch InRelease Réception de:2 http://archive.debian.org/debian-security stretch/updates InRelease [59,1 kB] Réception de:3 http://archive.debian.org/debian stretch Release [118 kB] Réception de:4 http://archive.debian.org/debian-security stretch/updates/main Sources [413 kB] Réception de:5 http://archive.debian.org/debian-security stretch/updates/main amd64 Packages [782 kB] Réception de:6 http://archive.debian.org/debian-security stretch/updates/main Translation-en [368 kB] Réception de:7 http://archive.debian.org/debian stretch Release.gpg [3 177 B] Réception de:8 http://archive.debian.org/debian stretch/main Sources [6 736 kB] Réception de:9 http://archive.debian.org/debian stretch/main amd64 Packages [7 080 kB] Réception de:10 http://archive.debian.org/debian stretch/main Translation-en [5 377 kB] Réception de:11 http://archive.debian.org/debian stretch/main Translation-fr [1 894 kB] 22,8 Mo réceptionnés en 24s (949 ko/s) Lecture des listes de paquets... Fait Construction de l'arbre des dépendances Lecture des informations d'état... Fait 358 packages can be upgraded. Run 'apt list --upgradable' to see them. trainee@web03:~$ exit déconnexion Connection to web03 closed.
trainee@debian11:~$ ssh -l trainee web04 The authenticity of host 'web04 (10.0.2.57)' can't be established. ECDSA key fingerprint is SHA256:sEfHBv9azmK60cjqF/aJgUc9jg56slNaZQdAUcvBOvE. Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added 'web04' (ECDSA) to the list of known hosts. Debian GNU/Linux 9 Linux web04.i2tch.loc 4.9.0-8-amd64 #1 SMP Debian 4.9.130-2 (2018-10-27) x86_64 The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Last login: Sun Mar 21 08:52:36 2021 from 10.0.2.10
Modifiez le contenu du fichier /etc/apt/sources.list :
trainee@web04:~$ sudo vi /etc/apt/sources.list trainee@web04:~$ cat /etc/apt/sources.list # # deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main #deb cdrom:[Debian GNU/Linux 9.6.0 _Stretch_ - Official amd64 NETINST 20181110-11:34]/ stretch main deb http://archive.debian.org/debian/ stretch main deb-src http://archive.debian.org/debian/ stretch main deb http://archive.debian.org/debian-security stretch/updates main deb-src http://archive.debian.org/debian-security stretch/updates main trainee@web04:~$ sudo apt update Ign:1 http://archive.debian.org/debian stretch InRelease Réception de:2 http://archive.debian.org/debian-security stretch/updates InRelease [59,1 kB] Réception de:3 http://archive.debian.org/debian stretch Release [118 kB] Réception de:4 http://archive.debian.org/debian stretch Release.gpg [3 177 B] Réception de:5 http://archive.debian.org/debian-security stretch/updates/main Sources [413 kB] Réception de:6 http://archive.debian.org/debian-security stretch/updates/main amd64 Packages [782 kB] Réception de:7 http://archive.debian.org/debian-security stretch/updates/main Translation-en [368 kB] Réception de:8 http://archive.debian.org/debian stretch/main Sources [6 736 kB] Réception de:9 http://archive.debian.org/debian stretch/main amd64 Packages [7 080 kB] Réception de:10 http://archive.debian.org/debian stretch/main Translation-fr [1 894 kB] Réception de:11 http://archive.debian.org/debian stretch/main Translation-en [5 377 kB] 22,8 Mo réceptionnés en 27s (843 ko/s) Lecture des listes de paquets... Fait Construction de l'arbre des dépendances Lecture des informations d'état... Fait 358 packages can be upgraded. Run 'apt list --upgradable' to see them. trainee@web04:~$ exit déconnexion Connection to web04 closed.
Utilisez ensuite la commande ansible avec le module ping :
trainee@debian11:~$ ansible all -i 10.0.2.54, -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host 10.0.2.54 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release
will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be
removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
10.0.2.54 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
trainee@debian11:~$ ansible all -i 10.0.2.55, -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host 10.0.2.55 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release
will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be
removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
10.0.2.55 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
trainee@debian11:~$ ansible all -i 10.0.2.56, -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host 10.0.2.56 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release
will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be
removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
10.0.2.56 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
trainee@debian11:~$ ansible all -i 10.0.2.57, -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host 10.0.2.57 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release
will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be
removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
10.0.2.57 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
trainee@debian11:~$
Utilisez de nouveau la commande ansible afin de vérifier le statut des machines :
trainee@debian11:~$ ansible all -i web01,web02,web03,web04 -m ping
[DEPRECATION WARNING]: Distribution debian 9.7 on host web01 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will
default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed
in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
web01 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
[DEPRECATION WARNING]: Distribution debian 9.7 on host web03 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will
default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed
in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
web03 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
[DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will
default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed
in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
web04 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
[DEPRECATION WARNING]: Distribution debian 9.7 on host web02 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will
default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed
in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
web02 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
Important : Notez que les résultats ne sont pas retournés dans un ordre séquentiel par rapport à la commande exécutée. En effet, ansible a paralléliser l'exécution des commandes.
Exécutez maintenant la commande uptime dans les machines web01, web02, web03 et web04 en utilisant le module command :
trainee@debian11:~$ ansible all -i web01,web02,web03,web04 -m command --args 'uptime' [DEPRECATION WARNING]: Distribution debian 9.7 on host web01 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. web01 | CHANGED | rc=0 >> 14:40:05 up 21 min, 1 user, load average: 0,01, 0,08, 0,15 [DEPRECATION WARNING]: Distribution debian 9.7 on host web02 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. web02 | CHANGED | rc=0 >> 14:40:05 up 21 min, 1 user, load average: 0,01, 0,08, 0,19 [DEPRECATION WARNING]: Distribution debian 9.7 on host web03 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. web03 | CHANGED | rc=0 >> 14:40:05 up 21 min, 1 user, load average: 0,13, 0,10, 0,21 [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. web04 | CHANGED | rc=0 >> 14:40:05 up 21 min, 1 user, load average: 0,00, 0,08, 0,22
LAB #2 - La Commande ansible-playbook
La commande ansible-playbook permet d’insérer la configuration d'Ansible dans des fichiers afin de pouvoir ré-exécuter les mêmes jeux de commandes à chaque fois. La commande ansible-playbook utilisent des Playbook Files ainsi que des Inventory Files.
2.1 - Playbook Files
Un Playbook File contient une liste de Plays qui regroupent des tâches, appelées des tasks. Chaque task est une commande à exécuter sur une machine cible :
Dans l'exemple suivant, le playbook contient deux Play commençant par le caractère - :
- hosts: all
become : true
tasks:
- name: installer un paquet
package: name=<paquet> state=present
- name: groupe
group:
name: <nom_groupe>
state: present
- hosts: equilibrage01
become : true
tasks:
- name: installer un paquet
package: name=<paquet> state=present
Dans cet exemple :
- Les deux sections hosts: sont dans une liste YAML. Chaque section est un dictionnaire YAML, aussi connu en tant que map ou hash. Le dictionnaire YAML contient trois champs - hosts:, become: et tasks:. Dans le deuxième task, le contenu de hosts est le nom d'un seul hôte. Ansible utilise l'Inventory File pour obtenir des informations concernant cet hôte,
- Le mot clef hosts: indique sur quel(s) hôte(s) les tasks doit(vent) être effectué(s). La valeur de hosts: est une valeur scalaire sous la forme d'une chaîne,
- Le mot clef become: est une valeur booléenne qui indique que les tâches doivent être accomplies par un utilisateur avec privilèges,
- Le mot clef tasks: contient une autre liste YAML qui spécifie les tâches à effectuer.
2.2 - Tasks
Un task est une tâche individuelle qui doit être accomplie :
tasks:
- name: installer un paquet
package: name=<paquet> state=present
- name: groupe
group:
name: <nom_groupe>
state: present
Dans cet exemple :
- Chaque task est un dictionnaire YAML contentant un champs optionnel - name et un module Ansible - dans le cas ci-dessus, package ou group,
- Le module Ansible package est une valeur scalaire qui contient une chaîne qui stipule le paquet à installer. Le contenu est composé de deux paramètres - name et state. Dans le cas de ce module la valeur du paramètre state peut être latest, present, absent ou le numéro d'une version du paquet à installer,
- Le module Ansible group est un dictionnaire YAML qui contient deux champs - name et state.
2.3 - Handlers
Un Handler est une tâche conditionnelle :
tasks:
- name: configure
copy:
src: paquet.conf.local
dest: /etc/paquet/paquet.conf
owner: root
group: root
mode: 0644
notify:
- restart service
Le mot clef notify appelle un handler identifié par restart service :
tasks:
- name: configure
copy:
src: paquet.conf.local
dest: /etc/paquet/paquet.conf
owner: root
group: root
mode: 0644
notify:
- restart service
handlers:
- name: restart service
service: name=<paquet.service> state=restarted
Dans cet exemple :
- Ansible compare le fichier local paquet.conf.local avec le fichier /etc/paquet/paquet.conf dans le système ciblé,
- En cas de différences, Ansible copie le fichier paquet.conf.local vers /etc/paquet/paquet.conf et appelle le handler restart service,
- Dans le cas contraire, le handler n'est pas appelé.
Important : Notez que les handlers sont appelés après l'exécution de tous les tasks. Pour appeler un handler immédiatement, il convient d'utiliser meta: flush_handlers à l'emplacement voulu.
2.4 - Modules
La liste complète des modules se trouve à cette adresse. Chaque module commence par vérifier si un task doit être effectué avant de l'entreprendre.
2.4.1 - Modules pour des Paquets
- Le module Ansible package est généralement une valeur scalaire qui contient une chaîne qui stipule le paquet à installer ou bien un dictionnaire. Le contenu est composé de deux paramètres - name et state. Dans le cas de ce module la valeur du paramètre state peut être latest, present, absent ou le numéro d'une version du paquet à installer. Ce module utilise le gestionnaire des paquets de la distribution concernée,
- Le module Ansible pip est décrit par deux paramètres - name et virtualenv. Dans le cas de ce module la valeur du paramètre virtualenv indique la valeur de l'environnement virtuel,
- Le module Ansible gem est décrit par deux paramètres - name et state. Dans le cas de ce module la valeur du paramètre state est similaire à celle du module package.
2.4.2 - Modules pour des Fichiers
- Le module Ansible copy copie un fichier du contrôleur vers un système distant. Ce module peut vérifier les propriétés du fichier telles son contenu, le propriétaire avec owner:, le groupe avec group: ou les permissions avec 0644,
- Le module Ansible template est similaire au module copy mais il met à jour le contenu avec des valeurs de variables qui lui sont fournies,
- Le module Ansible files crée ou supprime des fichiers et/ou des répertoires,
- Le module Ansible lineinfile trouve une ligne existante dans un fichier selon la valeur d'une expression régulière regexp: et compare cette ligne avec la valeur d'une ligne spécifiée par line:. Dans le cas où la ligne est différente de la valeur line:, Ansible modifie le fichier,
- Le module Ansible unarchive désarchive une archive sur le système distant. Avant de désarchiver l'archive, Ansible vérifie si le fichier spécifié par la valeur de creates existe ou pas. Dans le cas où le fichier n'existe pas, Ansible procède au désarchivage. Dans le cas contraire, Ansible considère que l'archive a déjà été désarchivé.
2.4.3 - Modules pour le Système
Les modules les plus importants dans cette catégorie sont :
- service,
- cron:,
- user:,
- group.
2.5 - Inventory Files
Un Ansible Inventory File :
- contrôle quels systèmes sont ciblés par ansible-playbook,
- permet des configurations par système,
- est un fichier au format INI.
L'inventory file par défaut est /etc/ansible/hosts.
Dans un tel fichier, on peut trouver des listes simples :
web01 web02 web03 web04 web05
des plages :
web [01:05]
des sections :
[basededonnees] basededonnees01
et des adresses IP :
10.0.2.14
Par exemple, l'Inventory File pour quatre systèmes différents pourrait ressembler à l'exemple suivant :
... web01 ansible_hostname=10.0.2.54 ansible_user=trainee ... web02 ansible_hostname=10.0.2.55 ansible_user=trainee ... web03 ansible_hostname=10.0.2.56 ansible_user=trainee ... web04 ansible_hostname=10.0.2.57 ansible_user=trainee ...
2.6 - Privilèges
Ansible a besoin d'obtenir les privilèges d'administration pour la plupart des tâches à accomplir. L'escalade des privilèges peut être configurée dans trois endroits différents grâce à l'utilisation :
- du mot clef become: dans un task auquel cas l'escalade des privilèges ne s'applique qu'à la taĉhe,
- du mot clef become: dans un play auquel cas l'escalade des privilèges s'applique à tous les tasks dans le play,
- des directives ansible_become=yes et ansible_become_user=<nom_utilisateur> dans le fichier Inventory File auquel cas l'escalade des privilèges s'applique à tous les play du serveur spécifié.
Notez qu'Ansible peut également utiliser d'autres mécanismes pour contrôler des systèmes :
- local - la connexion n'est pas effectuée par SSH car les tasks sont à effectuer sur le localhost,
- Winrm - le module Python Windows Remote Management qui peut être installé à côté d'Ansible et qui permet d'exécuter des commandes PowerShell,
- Docker - la commande docker exec. La configuration est effectuée par Ansible au lieu d'un DockerFile traditionnel.
2.6.1 - Création de Groupes
Ansible permet le regroupement d'hôtes dans des groupes. Prenons l'exemple suivant :
... [apache] web01 web02 [nginx] web03 web04 [equilibrage] equilibrage01 ...
Le groupe apache contient deux machines, le groupe nginx contient deux machines tandis que le groupe equilibrage n'en contient qu'un. Toute configuration appliquée au groupe apache, par exemple, s'applique aux deux machines dans le groupe.
Dans cet exemple, les quatre machines web0X sont sous Debian et utilisent l'utilisateur trainee pour l'escalade des privilèges tandis que le système equilibrage01 est sous CentOS et utilise l'utilisateur root.
Afin qu'Ansible sache quel utilisateur utilisé avec ssh, il convient de créer des groupes supplémentaires :
... [apache] web01 web02 [nginx] web03 web04 [debian:children] apache nginx [debian:vars] ansible_user=trainee [equilibrage] equilibrage01 [centos:children] equilibrage [centos:vars] ansible_user=root ...
Le groupe debian contient les deux groupes apache et nginx en tant qu'enfants. Toute configuration appliquée au groupe debian, s'applique aux quatre machines dans les groupes apache et nginx. Le groupe debian est configuré par une variable ansible_user=trainee.
Le groupe centos contient un seul groupe equilibrage en tant qu'enfant. Le groupe centos est configuré par une variable ansible_user=root.
Cette configuration permet de modifier le Playbook ainsi :
- hosts: all
become : true
tasks:
- name: groupe
group:
name: <nom_groupe>
state: present
- hosts: apache
become : true
tasks:
- name: installer Apache
package: name=apache state=present
- hosts: nginx
become : true
tasks:
- name: installer Nginx
package: name=nginx state=present
- hosts: equilibrage
become : true
tasks:
- name: installer HAProxy
package: name=haproxy state=present
Dans cet exemple, la valeur du mot clef hosts: est le nom d'un groupe.
Important : Notez qu'il existe un groupe spécial appelé all. Ce groupe n'a pas besoin d'être défini et contient l'ensemble des hôtes références dans l'Inventory File
Dans la machine virtuelle debian11, créez le fichier Inventory File suivant :
trainee@debian11:~$ vi inventory trainee@debian11:~$ cat inventory [basededonnees] web01 [dotcms] web02 web03 [equilibrage] web04 [debian:children] basededonnees dotcms equilibrage [debian:vars] ansible_user=trainee
Créez ensuite le Play Book suivant :
trainee@debian11:~$ vi playbook.yaml
trainee@debian11:~$ cat playbook.yaml
---
- hosts: basededonnees
become: true
tasks:
- name: install
package: name=postgresql state=present
- name: service
service: name=postgresql state=started enabled=yes
tags: service
- hosts: dotcms
become: true
tasks:
- name: install jre
package: name=openjdk-8-jre state=present
- hosts: equilibrage
become: true
tasks:
- name: install
package: name=haproxy state=present
- name: service
service: name=haproxy state=started enabled=yes
tags: service
Exécutez la commande ansible-playbook :
trainee@debian11:~$ ansible-playbook -i inventory playbook.yaml PLAY [basededonnees] ***************************************************************************************************************************************************************************************** TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web01 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web01] TASK [install] *********************************************************************************************************************************************************************************************** [WARNING]: Updating cache and auto-installing missing dependency: python-apt changed: [web01] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web01] PLAY [dotcms] ************************************************************************************************************************************************************************************************ TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web02 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web02] [DEPRECATION WARNING]: Distribution debian 9.7 on host web03 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web03] TASK [install jre] ******************************************************************************************************************************************************************************************* ok: [web02] ok: [web03] PLAY [equilibrage] ******************************************************************************************************************************************************************************************* TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web04] TASK [install] *********************************************************************************************************************************************************************************************** changed: [web04] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web01 : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web02 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web03 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web04 : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Il est possible de limiter l'action de la commande ansible-playbook avec l'option -l. Exécutez la commande ansible-playbook en limitant l'action d'ansible-playbook au groupe equilibrage :
trainee@debian11:~$ ansible-playbook -i inventory playbook.yaml -l equilibrage PLAY [basededonnees] ***************************************************************************************************************************************************************************************** skipping: no hosts matched PLAY [dotcms] ************************************************************************************************************************************************************************************************ skipping: no hosts matched PLAY [equilibrage] ******************************************************************************************************************************************************************************************* TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web04] TASK [install] *********************************************************************************************************************************************************************************************** ok: [web04] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web04 : ok=3 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Bien évidement il est aussi possible de limiter à une seule machine :
trainee@debian11:~$ ansible-playbook -i inventory playbook.yaml -l web04 PLAY [basededonnees] ***************************************************************************************************************************************************************************************** skipping: no hosts matched PLAY [dotcms] ************************************************************************************************************************************************************************************************ skipping: no hosts matched PLAY [equilibrage] ******************************************************************************************************************************************************************************************* TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web04] TASK [install] *********************************************************************************************************************************************************************************************** ok: [web04] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web04 : ok=3 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Notez que dans le fichier playbook.yaml se trouvent deux lignes dont le mot clef est tags:. Cette étiquette permet de limiter l'action de la commande ansible-playbook aux seuls services :
...
- name: service
service: name=postgresql state=started enabled=yes
tags: service
...
- name: service
service: name=haproxy state=started enabled=yes
tags: service
Exécutez de nouveau la commande ansible-playbook en limitant l'action aux seuls services :
trainee@debian11:~$ ansible-playbook -i inventory playbook.yaml --tags service PLAY [basededonnees] ***************************************************************************************************************************************************************************************** TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web01 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web01] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web01] PLAY [dotcms] ************************************************************************************************************************************************************************************************ TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web03 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web03] [DEPRECATION WARNING]: Distribution debian 9.7 on host web02 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web02] PLAY [equilibrage] ******************************************************************************************************************************************************************************************* TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web04] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web01 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web02 : ok=1 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web03 : ok=1 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 web04 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Il est aussi possible de combiner les options –tags et -l :
trainee@debian11:~$ ansible-playbook -i inventory playbook.yaml --tags service -l equilibrage PLAY [basededonnees] ***************************************************************************************************************************************************************************************** skipping: no hosts matched PLAY [dotcms] ************************************************************************************************************************************************************************************************ skipping: no hosts matched PLAY [equilibrage] ******************************************************************************************************************************************************************************************* TASK [Gathering Facts] *************************************************************************************************************************************************************************************** [DEPRECATION WARNING]: Distribution debian 9.7 on host web04 should use /usr/bin/python3, but is using /usr/bin/python for backward compatibility with prior Ansible releases. A future Ansible release will default to using the discovered platform python for this host. See https://docs.ansible.com/ansible/2.10/reference_appendices/interpreter_discovery.html for more information. This feature will be removed in version 2.12. Deprecation warnings can be disabled by setting deprecation_warnings=False in ansible.cfg. ok: [web04] TASK [service] *********************************************************************************************************************************************************************************************** ok: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web04 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
LAB #3 - La Commande ansible-galaxy
3.1 - Utiliser des Rôles avec un Play Book
Les Rôles permettent la création d'une bibliothèque réutilisable.
Un Rôle est un répertoire contenant les sous-répertoires suivants :
- defaults
- contient des variables par défaut de basses priorités qui peuvent être sur-chargées par des variables ailleurs,
- files,
- contient des fichiers à déployer aux systèmes distants,
- handlers,
- contient les handlers,
- meta,
- contient entre autre des informations sur des dépendances entre les Rôles,
- tasks,
- contient les actions à effectuer,
- templates,
- contient des fichiers qui peuvent être customisé avec des variables avant d'être déployés,
- var,
- contient des variables de configuration de haute priorité, difficilement sur-chargées par des variables ailleurs.
Important : Notez que seul le répertoire tasks est obligatoire.
Notez que le module copy: ne référence un fichier que par son nom et son éventuelle extension :
... copy: src: myfile.conf ...
Ansible recherche ce fichier dans plusieurs répertoires dans l'ordre qui suit :
- le répertoire files du Rôle,
- le répertoire tasks du Rôle,
- le répertoire du Rôle lui-même,
- le répertoire files du répertoire dans lequel se trouve le fichier playbook.yaml,
- le répertoire dans lequel se trouve le fichier playbook.yaml.
Par exemple :
.
├── 5-myfile.conf
├── files
│ └── 4-myfile.conf
├── playbook.yaml
├── roles
└── dotcms
├── 3-myfile.conf
├── defaults
│ └── main.yaml
├── files
│ └── 1-myfile.conf
├── handlers
│ └── main.yaml
├── tasks
│ ├── 2-myfile.conf
│ └── main.yaml
└── templates
├── context.xml
└── dotcms.service
Dans le cas de l'utilisation de Rôles, le fichier playbook.yaml devient plus simplifié. Par exemple :
- hosts: basededonnees
become: true
roles:
- basededonnees
- hosts: dotcms
become: true
roles:
- java
- dotcms
- hosts: equilibrage
become: true
roles:
- equilibrage
3.2 - Ansible Galaxy
Ansible Galaxy est un dépôt de Rôles créées par des tierces personnes. Ce dépôt peut être consulté à l'adresse https://galaxy.ansible.com/ :
Recherchez le mot clef java avec un premier filtre de type Rôle et un deuxième filtre de type Download Count :
Consultez la première dans la liste :
Copiez la commande d'installation :
Important : Notez que la convention utilisée pour les noms est nom_utilisateur.rôle.
Dans la machine debian11, collez la commande copiée et exécutez-la :
trainee@debian11:~$ ansible-galaxy install geerlingguy.java Starting galaxy role install process - downloading role 'java', owned by geerlingguy - downloading role from https://github.com/geerlingguy/ansible-role-java/archive/2.3.1.tar.gz - extracting geerlingguy.java to /home/trainee/.ansible/roles/geerlingguy.java - geerlingguy.java (2.3.1) was installed successfully
Installez le paquet tree et consultez le répertoire /home/trainee/.ansible/roles/geerlingguy.java :
trainee@debian11:~$ su -
Password: fenestros
root@debian11:~# which tree
root@debian11:~# apt install tree
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following packages were automatically installed and are no longer required:
libopengl0 linux-headers-5.10.0-15-amd64 linux-headers-5.10.0-15-common
Use 'apt autoremove' to remove them.
The following NEW packages will be installed:
tree
0 upgraded, 1 newly installed, 0 to remove and 22 not upgraded.
Need to get 49.6 kB of archives.
After this operation, 118 kB of additional disk space will be used.
Get:1 http://deb.debian.org/debian bullseye/main amd64 tree amd64 1.8.0-1+b1 [49.6 kB]
Fetched 49.6 kB in 0s (3,346 kB/s)
Selecting previously unselected package tree.
(Reading database ... 206553 files and directories currently installed.)
Preparing to unpack .../tree_1.8.0-1+b1_amd64.deb ...
Unpacking tree (1.8.0-1+b1) ...
Setting up tree (1.8.0-1+b1) ...
Processing triggers for man-db (2.9.4-2) ...
root@debian11:~# exit
logout
trainee@debian11:~$ tree /home/trainee/.ansible/roles/geerlingguy.java
/home/trainee/.ansible/roles/geerlingguy.java
├── defaults
│ └── main.yml
├── LICENSE
├── meta
│ └── main.yml
├── molecule
│ └── default
│ ├── converge.yml
│ └── molecule.yml
├── README.md
├── tasks
│ ├── main.yml
│ ├── setup-Debian.yml
│ ├── setup-FreeBSD.yml
│ └── setup-RedHat.yml
├── templates
│ └── java_home.sh.j2
└── vars
├── Debian-10.yml
├── Debian-11.yml
├── Debian-12.yml
├── Debian-8.yml
├── Debian-9.yml
├── Fedora.yml
├── FreeBSD.yml
├── RedHat-7.yml
├── RedHat-8.yml
├── RedHat-9.yml
├── Ubuntu-12.yml
├── Ubuntu-14.yml
├── Ubuntu-16.yml
├── Ubuntu-18.yml
├── Ubuntu-20.yml
└── Ubuntu-22.yml
7 directories, 27 files
Important : Notez que dans ce cas il n'y a pas eu de dépendances. Par contre la commande ansible-galaxy sait résoudre et gérer les dépendances.
Créez maintenant un fichier Play Book pour utiliser ce Rôle :
trainee@debian11:~$ vi playbook_java.yaml
trainee@debian11:~$ cat playbook_java.yaml
---
- hosts: all
become: true
roles:
- geerlingguy.java
Avant d'excuter ce playbook, créez le fichier ~/.ansible.cfg :
trainee@debian11:~$ vi .ansible.cfg trainee@debian11:~$ cat .ansible.cfg [defaults] deprecation_warnings=False
Important : Le comportement d'Ansible peut être configuré par des directives dans la variable d'environnement ANSIBLE_CONFIG ou dans le fichier ansible.cfg dans le répertoire courant de travail ou dans le fichier .ansible.cfg dans le répertoire personnel de l'utilisateur ou dans le fichier /etc/ansible/ansible.cfg, selon le premier qui est trouvé. Pour une liste complète des directives, consultez la page https://docs.ansible.com/ansible/latest/reference_appendices/config.html.
Pour consultez l'ensemble des variables, exécutez la commande suivante :
trainee@debian11:~$ ansible-config list | more
ACTION_WARNINGS:
default: true
description:
- By default Ansible will issue a warning when received from a task action (module
or action plugin)
- These warnings can be silenced by adjusting this setting to False.
env:
- name: ANSIBLE_ACTION_WARNINGS
ini:
- key: action_warnings
section: defaults
name: Toggle action warnings
type: boolean
version_added: '2.5'
AGNOSTIC_BECOME_PROMPT:
default: true
description: Display an agnostic become prompt instead of displaying a prompt containing
the command line supplied become method
env:
- name: ANSIBLE_AGNOSTIC_BECOME_PROMPT
ini:
- key: agnostic_become_prompt
section: privilege_escalation
name: Display an agnostic become prompt
type: boolean
version_added: '2.5'
yaml:
key: privilege_escalation.agnostic_become_prompt
ALLOW_WORLD_READABLE_TMPFILES:
default: false
deprecated:
alternatives: mostly the same config will work, but now controlled from the plugin
itself and not using the general constant.
collection_name: ansible.builtin
version: '2.14'
why: moved to a per plugin approach that is more flexible
description:
- This makes the temporary files created on the machine world-readable and will
issue a warning instead of failing the task.
- It is useful when becoming an unprivileged user.
env: []
ini:
- key: allow_world_readable_tmpfiles
section: defaults
name: Allow world-readable temporary files
type: boolean
version_added: '2.1'
yaml:
key: defaults.allow_world_readable_tmpfiles
ANSIBLE_CONNECTION_PATH:
default: null
description:
- Specify where to look for the ansible-connection script. This location will be
checked before searching $PATH.
- If null, ansible will start with the same directory as the ansible script.
--More--
Exécutez maintenant la commande ansible-playbook :
trainee@debian11:~$ ansible-playbook -i inventory playbook_java.yaml PLAY [all] *************************************************************************************************************************************************************************************************** TASK [Gathering Facts] *************************************************************************************************************************************************************************************** ok: [web01] ok: [web02] ok: [web03] ok: [web04] TASK [geerlingguy.java : Include OS-specific variables for Fedora or FreeBSD.] ******************************************************************************************************************************* skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : Include version-specific variables for CentOS/RHEL.] ******************************************************************************************************************************** skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : Include version-specific variables for Ubuntu.] ************************************************************************************************************************************* skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : Include version-specific variables for Debian.] ************************************************************************************************************************************* ok: [web01] ok: [web02] ok: [web03] ok: [web04] TASK [geerlingguy.java : Define java_packages.] ************************************************************************************************************************************************************** ok: [web01] ok: [web02] ok: [web03] ok: [web04] TASK [geerlingguy.java : include_tasks] ********************************************************************************************************************************************************************** skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : include_tasks] ********************************************************************************************************************************************************************** included: /home/trainee/.ansible/roles/geerlingguy.java/tasks/setup-Debian.yml for web01, web02, web03, web04 TASK [geerlingguy.java : Ensure 'man' directory exists.] ***************************************************************************************************************************************************** skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : Ensure Java is installed.] ********************************************************************************************************************************************************** changed: [web03] changed: [web04] changed: [web02] changed: [web01] TASK [geerlingguy.java : include_tasks] ********************************************************************************************************************************************************************** skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] TASK [geerlingguy.java : Set JAVA_HOME if configured.] ******************************************************************************************************************************************************* skipping: [web01] skipping: [web02] skipping: [web03] skipping: [web04] PLAY RECAP *************************************************************************************************************************************************************************************************** web01 : ok=5 changed=1 unreachable=0 failed=0 skipped=7 rescued=0 ignored=0 web02 : ok=5 changed=1 unreachable=0 failed=0 skipped=7 rescued=0 ignored=0 web03 : ok=5 changed=1 unreachable=0 failed=0 skipped=7 rescued=0 ignored=0 web04 : ok=5 changed=1 unreachable=0 failed=0 skipped=7 rescued=0 ignored=0
Notez qu'Ansible a pu localiser le Rôle grâce à la valeur de la variable Ansible ANSIBLE_ROLES_PATH. La valeur par défaut de cette variable est ~/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles :
trainee@debian11:~$ ansible-config dump |grep ROLES_PATH DEFAULT_ROLES_PATH(default) = ['/home/trainee/.ansible/roles', '/usr/share/ansible/roles', '/etc/ansible/roles']
Le PLAY RECAP contient 7 catégories :
- ok
- le nombre de tâches qui ont été traitées sans erreur
- changed
- le nombre de tâches qui ont effectué des modifications sur un des hôtes concernés
- unreachable
- le nombre de tâches qui n'ont pas été exécutées parce que l'hôte ne pouvait pas être contacté
- failed
- le nombre de tâches en erreur pour lesquelles la valeur de ignore_errors: était fixée à false
- skipped
- le nombre de tâches qui n'ont pas été exécutées parce que la valeur de la clause when était fausse
- rescued
- le nombre de tâches de type rescue qui ont été exécutées suite à une erreur ailleurs dans le playbook
- ignored
- le nombre de tâches en erreur pour lesquelles la valeur de ignore_errors: était fixée à true
Pour mieux expliquer la catégorie rescued, considérez le code suivant :
---
- name: Ansible Blocks
hosts: server1
gather_facts: false
tasks:
- block:
- name: List home directory content
command: "ls -l ~/"
- name: Failing intentionally
command: "ls -l /tmp/does-not-exist"
rescue:
- name: Rescue block (perform recovery)
debug:
msg: "Something went wrong, cleaning up.."
always:
- name: This will execute always
debug:
msg: "I will execute even in failure scenario"
Dans le cas ci-dessus, la deuxième tâche dans la section block va générer une erreur. Dans ce cas la tâche dans la section rescue sera exécutée. Dans tous les cas la tâche dans la section always sera exécutée.
Copyright © 2023 Hugh Norris.
