Vous êtes ici : Formations en Ligne Gratuites » Catalogue » workbooks » CentOS » CentOS 8 » LDF900 - Prérequis » LDF902 - Les Commandes ansible, ansible-playbook et ansible-galaxy

Ceci est une ancienne révision du document !

Table des matières

Version : 2023.01

Dernière mise-à-jour : 2024/02/20 08:29

LDF902 - Les Commandes ansible, ansible-playbook et ansible-galaxy

Contenu du Module

  • LDF902 - 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.

Piste : • LDF100 - Debian 8 Linux : User • LDF904 - Utilisation d'Ansible avec Docker et Windows • LDF905 - Automatiser l'Administration Système de CentOS 8 • LDF706 - Validation de la Formation • LCF705 - Validation de la Formation • GP1000 - ITIL V4 • SER300 - Administration d'un serveur d'applications JEE avec Tomcat • Programme UX005 • LDF903 - Rôles, Gabarits, Variables et Facts • LDF902 - Les Commandes ansible, ansible-playbook et ansible-galaxy

Menu