Guide 07 / 3
Lexique Ansible
Décrypter le fonctionnement d’Ansible et lire un playbook sans confondre hôte, tâche, module et rôle.
Distinguer le nœud de contrôle des hôtes gérés, expliquer l’idempotence et lire l’organisation d’un playbook.
01 · Comprendre l’automatisation
Ansible automatise des opérations techniques en décrivant l’état attendu : il privilégie les tâches reproductibles plutôt que les manipulations manuelles.
Ansible
Outil d’automatisation et de configuration des systèmes, applications et infrastructures. Il exécute des tâches sur des cibles décrites dans un inventaire.
Exemple
Exemple métier : préparer 12 serveurs web de la même manière.
Ansible n’est pas un orchestrateur de conteneurs : il complète Docker et Kubernetes.
Nœud de contrôle (control node)
Machine depuis laquelle on lance les commandes et les playbooks. Elle possède Ansible et les fichiers du projet.
Exemple
Ordinateur du formateur ou VM Linux de gestion.
Les serveurs Linux gérés n’ont généralement pas besoin du programme Ansible installé.
Nœud géré (managed node)
Serveur ou équipement sur lequel Ansible intervient, souvent via SSH. Il est décrit dans l’inventaire.
Exemple
vm-web-01 est configurée depuis le poste de contrôle.
Pour les modules Python, une version compatible de Python doit être disponible sur la cible.
Sans agent (agentless)
Modèle où aucun service Ansible permanent n’est requis sur les hôtes Linux cibles ; les tâches utilisent notamment SSH.
Exemple
Une connexion SSH suffit dans un cas Linux habituel.
Un réseau accessible, des identifiants valides et des droits suffisants restent indispensables.
Infrastructure as Code (IaC)
Approche consistant à exprimer l’infrastructure sous forme de fichiers versionnés et reproductibles.
Exemple
Le dépôt Git contient inventory.ini et playbooks/web.yml.
Relire et valider les changements comme du code applicatif.
État désiré
Résultat à obtenir sur la cible : paquet installé, fichier présent, service démarré.
Exemple
state: present demande qu’un paquet soit installé.
Déclarer le résultat est souvent plus fiable que lancer une suite de commandes shell.
Idempotence
Propriété d’une opération répétée qui ne modifie plus le système lorsque l’état demandé est déjà atteint.
Exemple
Relancer « nginx installé » ne réinstalle pas nginx sans raison.
Un module est idempotent selon sa fonction et les paramètres employés ; « shell » ne l’est pas automatiquement.
Gestion de configuration
Maintien d’un ensemble d’équipements dans une configuration définie, malgré les interventions et changements.
Exemple
S’assurer que chrony est installé sur tous les serveurs.
02 · Inventaire et connexion
Avant d’automatiser, il faut savoir quelles machines sont visées et comment Ansible y accède.
Inventory (inventaire)
Fichier ou source dynamique référençant les machines et leurs groupes, avec éventuellement des paramètres de connexion.
Exemple
[web]
web1 ansible_host=192.0.2.11
web2 ansible_host=192.0.2.12
192.0.2.0/24 est une plage d’exemple ; remplacer par les IP du TP.
Host (hôte)
Entrée de l’inventaire qui désigne une machine et sert d’identifiant dans les commandes Ansible.
Exemple
web1 peut pointer vers 192.0.2.11 via ansible_host.
Group (groupe)
Ensemble nommé de machines pour lancer des tâches sur un périmètre fonctionnel.
Exemple
[web], [db], [prod] et [lab].
Host pattern
Expression sélectionnant les cibles d’un play ou d’une commande.
Exemple
hosts: web ; ansible web -i inventory.ini -m ping
all vise toutes les cibles déclarées ; éviter all pour les opérations risquées.
ansible_host
Variable fixant le nom DNS ou l’IP utilisée pour atteindre un hôte.
Exemple
web1 ansible_host=192.0.2.11
ansible_user
Variable précisant le compte utilisé pour la connexion distante.
Exemple
ansible_user=deployer
Les droits de ce compte conditionnent les opérations possibles.
ansible_connection
Mode de transport vers la cible (ssh, local, winrm selon environnement).
Exemple
ansible_connection=local pour un laboratoire local.
Clé SSH
Paire de clés permettant de s’authentifier sans transmettre de mot de passe à chaque connexion.
Exemple
ssh -i ~/.ssh/id_ed25519 deployer@192.0.2.11
Ne stocker aucune clé privée dans le dépôt Git.
group_vars / host_vars
Dossiers conventionnels de variables, respectivement partagées par un groupe ou propres à un hôte.
Exemple
group_vars/web.yml : http_port: 8080
Une valeur définie dans plusieurs emplacements suit des règles de précédence.
Inventaire dynamique
Plugin ou source produisant automatiquement une liste de machines depuis un cloud ou un système de gestion.
Exemple
Découvrir les VM d’un projet cloud sans modifier un fichier INI.
03 · Construire un playbook
Un playbook est un scénario YAML : il associe des cibles, des tâches et des paramètres. Il se lit de haut en bas.
Playbook
Fichier YAML contenant une liste de plays ; il constitue la procédure d’automatisation.
Exemple
ansible-playbook -i inventory.ini site.yml
Play
Bloc qui associe une sélection d’hôtes, une politique d’exécution et des tâches.
Exemple
- name: Serveurs web
hosts: web
become: true
tasks: ...
Task (tâche)
Étape nommée demandant à Ansible d’exécuter un module avec ses arguments sur la cible.
Exemple
- name: Installer nginx
ansible.builtin.apt:
name: nginx
state: present
Module
Unité fonctionnelle Ansible qui réalise une opération : paquet, fichier, service, utilisateur ou requête API.
Exemple
ansible.builtin.copy copie un fichier sur une cible.
Préférer un module dédié à une commande shell lorsque c’est possible.
FQCN
Nom complet d’un module avec son espace de noms et sa collection, pour éviter les ambiguïtés.
Exemple
ansible.builtin.service plutôt que service.
Collection
Paquet distribuant des modules, plugins et parfois des rôles pour une technologie particulière.
Exemple
community.docker ou kubernetes.core
Certaines collections sont à installer séparément de ansible-core.
Role (rôle)
Structure de dossiers réutilisable pour regrouper tâches, handlers, variables, templates et fichiers.
Exemple
roles/nginx/tasks/main.yml
Utile pour partager une procédure entre plusieurs projets.
Handler
Tâche différée, déclenchée par notify lorsqu’une tâche a signalé un changement.
Exemple
Recharger nginx seulement si sa configuration a changé.
Les handlers se déclenchent normalement à la fin du play ou lors d’un flush.
notify
Mot-clé permettant d’avertir un handler à la suite d’un changement réel.
Exemple
notify: Recharger nginx
become
Élévation de privilèges sur la cible, par exemple via sudo, pour installer un paquet ou écrire dans /etc.
Exemple
become: true
Ne signifie pas « se connecter directement en root ».
gather_facts
Étape de collecte de renseignements système, activée par défaut sur beaucoup de plays.
Exemple
gather_facts: true ; ansible_facts["os_family"]
04 · Variables, logique et réutilisation
Les variables rendent un même playbook réutilisable sur plusieurs groupes ou environnements.
Variable
Nom donnant accès à une donnée de configuration sans dupliquer le playbook.
Exemple
http_port: 8080 ; {{ http_port }}
Jinja2
Moteur de gabarits utilisé pour injecter des variables, expressions et conditions dans les fichiers ou paramètres.
Exemple
server_name {{ site_hostname }};
Garder les expressions simples ; relire les valeurs rendues.
Template (.j2)
Modèle de fichier transformé avec les variables avant d’être installé sur l’hôte.
Exemple
templates/site.conf.j2 → /etc/nginx/sites-available/site
Condition when
Condition décidant si une tâche doit s’exécuter en fonction d’une valeur ou de faits.
Exemple
when: ansible_facts["os_family"] == "Debian"
Boucle loop
Répète une même tâche sur une liste, sans recopier le YAML.
Exemple
loop: ["curl", "git", "htop"]
register
Stocke le résultat d’une tâche pour l’analyser dans les tâches suivantes.
Exemple
register: resultat_nginx
changed / ok / failed / skipped
États renvoyés pour chaque tâche : modification effectuée, déjà conforme, échec ou tâche ignorée.
Exemple
changed=0 lors d’une seconde exécution idempotente.
Un récapitulatif sans erreur ne prouve pas à lui seul que le service répond correctement.
Precedence des variables
Règles qui déterminent quelle valeur l’emporte lorsqu’une variable existe à plusieurs endroits.
Exemple
Une variable -e peut écraser une variable group_vars.
Éviter de définir le même paramètre dans plusieurs emplacements.
05 · Contrôle, sécurité et exploitation
Une automatisation utile doit être vérifiable, limitée à un périmètre et ne jamais exposer ses secrets.
Check mode
Simulation estimant les modifications sans les appliquer, lorsque les modules le permettent.
Exemple
ansible-playbook site.yml --check
Certains modules ne prédisent pas tous les changements : la simulation n’est pas une preuve absolue.
Diff mode
Affiche les différences avant/après pour des modules compatibles, notamment les templates.
Exemple
ansible-playbook site.yml --check --diff
La sortie peut contenir des données sensibles ; la protéger.
Ansible Vault
Mécanisme de chiffrement de variables ou fichiers au repos au sein d’un projet Ansible.
Exemple
ansible-vault encrypt group_vars/prod/vault.yml
Vault ne protège pas automatiquement les secrets après leur déchiffrement ni dans les logs.
no_log
Option qui masque le résultat habituel d’une tâche, utile lorsqu’elle manipule des secrets.
Exemple
no_log: true
Ne remplace ni le chiffrement ni une gestion correcte des permissions.
Privilege minimal
Principe consistant à n’accorder que les droits nécessaires aux comptes et automatisations.
Exemple
sudo uniquement pour installer les paquets requis.
Serial / rolling update
Exécute le play sur des lots limités de machines plutôt que simultanément.
Exemple
serial: 1 pour mettre à jour un serveur à la fois.
Prévoir la disponibilité et la capacité restante avant de retirer un nœud de service.
ansible.cfg
Fichier de configuration du projet Ansible : inventaire par défaut, comportements, chemins, etc.
Exemple
[defaults]
inventory = inventory.ini
Vérifier le fichier de configuration réellement chargé avec ansible --version.
Ansible Galaxy
Commande et référentiel pour récupérer, installer et organiser des collections ou rôles.
Exemple
ansible-galaxy collection install community.docker