Variables Ansible

Définition d’une variable

Les variables facilitent la gestion des données qui ne sont pas statiques, notamment dans les playbooks de Ansible. Ce chapitre a pour objectif de présenter ces différents points :

Utilisation de variables Ansible

En plus des variables définies par l’utilisateur, il est possible d’accéder aux variables que Ansible fournit. En effet, chaque « play » exécute automatiquement le module setup avant la première tâche dans le but de rassembler les faits (facts en anglais). Il s’agit de la tâche Gathering Facts.

Exécution du module setup sur la machine locale

[root@server1 projet]# ansible localhost -m setup 
localhost | SUCCESS => { 
   "ansible_facts": { 
       "ansible_all_ipv4_addresses": [ 
           "10.14.8.0" 
       ], 
       "ansible_all_ipv6_addresses": [ 
           "fe80::8a9b:6241:9ed3:ef1a" 
       ], 
       "ansible_apparmor": { 
           "status": "disabled" 
       }, 
       "ansible_architecture": "x86_64", 
 
**** sortie tronquée **** 
 
 
       "ansible_distribution": "CentOS", 
       "ansible_bios_date": "04/01/2014", ...

Récupérer le résultat d’une commande

L’instruction register permet de récupérer le résultat d’une commande, qui sera enregistré dans une variable temporaire. Ce qui permettra d’y accéder ultérieurement. 

Récupérer le résultat d’une commande dans un playbook

La commande shell ls /home va être exécutée sur toutes les machines gérées définies dans l’inventaire. Avec l’instruction register, déclarez une variable home_resultat pour récupérer le résultat :

--- 
- name: Récupérer le résultat d'une commande ls /home 
  hosts: all 
  tasks: 
    - name: contenu de /home 
      shell: ls /home 
      register: home_resultat 
 
    - name: affiche la liste des valeurs 
      debug: 
        var: home_resultat 

Vous obtenez toutes les valeurs de retour :

[root@server1 projet]# ansible-playbook pb.yml 
 
PLAY [Récupérer le résultat d'une commande ls /home]*********** 
 
TASK [Gathering Facts] **************************************** 
ok: [server3.staff.local] 
ok: [server2.staff.local] 
 
TASK [contenu de /home] *************************************** 
changed: [server3.staff.local] 
changed: [server2.staff.local] 
 
TASK [affiche la liste des valeurs] *************************** 
ok: [server2.staff.local] => { 
   "home_resultat": { 
       "changed": true, 
       "cmd": "ls /home", 
       "delta": "0:00:00.004417", 
       "end": "2019-12-29...

Variables externes

Les variables peuvent être déclarées dans un fichier externe au playbook. Par conséquent, il faudra définir ce fichier dans le playbook avec l’instruction vars_files.

Variables définies en dehors du playbook

Créez un répertoire pour stocker les fichiers de variables externes :

root@server1 projet]# mkdir vars 
[root@server1 projet]# 

Puis avec l’éditeur de texte vi, concevez le fichier ./vars/ext_vars.yml où seront définies les variables externes comme ceci :

[root@server1 projet]# cat vars/ext_vars.yml 
--- 
port_ssh: 80 
service: 
 debian: apache2 
 rhel: httpd 
[root@server1 projet]# 

Le contenu du fichier playbook :

[root@server1 projet]# cat pb.yml 
--- 
- name: Variables définies dans un fichier externe 
  hosts: all 
  vars_files: vars/ext_vars.yml 
  tasks: 
    - name: "Afficher les variables" 
      debug: 
        msg: 
          - "Port TCP {{ port_ssh }}" 
          - "Service web Debian {{ service['debian'] }}" 
          - "Service Web RHEL   {{ service.rhel }}" 
[root@server1...

Variables définies sur la ligne de commande

Comme vu précédemment, les variables d’inventaire sont remplacées par les variables définies dans un playbook. Ces dernières peuvent être aussi remplacées par des variables qui sont passées en tant qu’arguments sur la ligne de commande. Elles sont appelées variables supplémentaires.

Les variables supplémentaires sont utiles lorsqu’il faut remplacer la valeur d’une variable définie pour une exécution ponctuelle d’un playbook.

Interprétation des variables

[root@server1 projet]# ansible-playbook playbook.yml \ 
> -e "distro=Red Hat" 
 
PLAY [Découvrir les variables de Ansible]*********************** 
 
TASK [Gathering Facts]****************************************** 
ok: [server3.staff.local] 
ok: [server2.staff.local] 
 
TASK [Afficher les variables] *********************************** 
ok: [server2.staff.local] => { 
   "msg": [ 
       "Red", 
       "Je suis dans le dossier host_vars" 
   ] 
} 
 
**** sortie tronquée ****  

Si vous essayez de passer en argument la valeur d’une variable avec un espace ou d’autres caractères sujets à être interprétés...

Chiffrer les variables

Avec Ansible Vault, il est possible de chiffrer des variables sensibles qui stockent par exemple des mots de passe.

[root@server1 projet]# ansible-vault create user_david.yml 
New Vault password: stage 
Confirm New Vault password: stage 

--- 
- name: Création de l'utilisateur David Lamber 
  hosts: all 
  tasks: 
    - name: David Lamber 
      user: 
        name: david 
        group: users 
        groups: adm,sys 
        state: present 
        shell: /bin/bash 
        password: "{{ david_passwd }}" 
        generate_ssh_key: true 
  vars: ...