Guide 09 / 3
Configuration Ansible et cas métier
Comprendre les fichiers du projet, les modules et sept scénarios d’automatisation directement exploitables.
Adapter un projet Ansible pour des serveurs Linux, Nginx, SSH, Docker Compose et Kubernetes.
01 · Lire la structure d’un projet Ansible
Un projet maintenable sépare les cibles, la configuration générale, les variables, les scripts et les templates.
Arborescence recommandée
Séparer inventory, playbooks, templates, files, roles et requirements.yml pour distinguer le ciblage des opérations.
Exemple
ansible.cfg
inventory.ini
site.yml
group_vars/web.yml
templates/site.conf.j2
roles/
ansible.cfg
Configuration locale d’exécution du projet. Le champ inventory évite de répéter -i ; les autres réglages doivent être adaptés.
Exemple
[defaults]
inventory = inventory.ini
host_key_checking = True
Ne désactiver ni la vérification SSH ni les avertissements par facilité.
inventory.ini
Décrit les serveurs réels ou virtuels qui seront gérés et les répartit en groupes.
Exemple
[web]
web1 ansible_host=192.0.2.11
web2 ansible_host=192.0.2.12
[web:vars]
ansible_user=deployer
group_vars/web.yml
Valeurs communes aux serveurs web d’un groupe.
Exemple
site_hostname: demo.example.test
http_port: 80
requirements.yml
Déclare les collections externes nécessaires pour reproduire le projet sur un autre poste.
Exemple
collections:
- name: community.docker
- name: kubernetes.core
02 · Clés YAML et exécution
Les fichiers playbook suivent une hiérarchie : play → tâches → module et arguments.
hosts
Sélectionne les hôtes visés par le play selon l’inventaire.
Exemple
- hosts: web
Cette clé définit le périmètre : contrôler les cibles avant toute exécution.
name
Donne un intitulé lisible à une tâche ou un play et facilite les journaux et diagnostics.
Exemple
- name: Configurer nginx
become / become_user
Permet d’exécuter des tâches avec les permissions d’un autre compte, souvent root via sudo.
Exemple
become: true
become_user: root
tasks / handlers
tasks contient les opérations à effectuer ; handlers les opérations déclenchées uniquement après changement.
Exemple
notify: Recharger nginx
vars / vars_files
Définit des variables directement dans le play ou charge un fichier de variables.
Exemple
vars:
http_port: 8080
when
Condition d’exécution calculée pour chaque hôte.
Exemple
when: ansible_facts["os_family"] == "Debian"
loop
Parcourt une liste et expose chaque élément dans item.
Exemple
loop:
- curl
- git
register
Enregistre la réponse d’un module et permet de tester changed, failed ou stdout.
Exemple
register: resultat
notify
Demande l’exécution différée d’un handler si la tâche notifiée a changé quelque chose.
Exemple
notify: Recharger nginx
serial
Limite le nombre d’hôtes traités simultanément au sein d’un play.
Exemple
serial: 1
check_mode / changed_when
Ajuste le comportement du mode vérification ou la détection de modification dans des cas précis.
Exemple
changed_when: false pour une commande d’observation
Éviter de masquer arbitrairement les changements ou les échecs.
no_log
Empêche l’affichage habituel des paramètres et résultats sensibles d’une tâche.
Exemple
no_log: true
Ne pas confondre masquage des logs et chiffrement des secrets.
03 · Modules essentiels pour les cas métier
Chaque module répond à un besoin métier spécifique et possède des paramètres documentés. Les exemples supposent Linux Debian/Ubuntu, sauf mention contraire.
ansible.builtin.apt
Gère les paquets Debian/Ubuntu selon l’état souhaité.
Exemple
ansible.builtin.apt:
name: nginx
state: present
update_cache: true
ansible.builtin.package
Interface générique de gestion de paquets ; délègue à un gestionnaire sous-jacent.
Exemple
ansible.builtin.package:
name: curl
state: present
ansible.builtin.file
Gère dossiers, permissions, liens et suppressions de chemins.
Exemple
ansible.builtin.file:
path: /opt/monapp
state: directory
mode: "0755"
ansible.builtin.copy
Transfère un fichier statique ou crée un fichier via content.
Exemple
ansible.builtin.copy:
src: files/index.html
dest: /var/www/html/index.html
ansible.builtin.template
Rend un modèle Jinja2 sur la cible, avec variables et éventuellement une commande de validation.
Exemple
ansible.builtin.template:
src: templates/site.conf.j2
dest: /etc/nginx/sites-available/site
backup: true
Après rendu, exécuter nginx -t avant de recharger le service ; backup: true conserve la version précédente.
ansible.builtin.service
Assure qu’un service est démarré, arrêté ou activé au démarrage.
Exemple
ansible.builtin.service:
name: nginx
state: started
enabled: true
ansible.builtin.user
Crée et configure des comptes Unix selon les paramètres définis.
Exemple
ansible.builtin.user:
name: deploiement
state: present
community.docker.docker_compose_v2
Pilote les services d’un dossier Compose via le plugin Docker Compose V2 disponible sur l’hôte.
Exemple
community.docker.docker_compose_v2:
project_src: /opt/portail
state: present
Nécessite la collection community.docker, Docker et le plugin Compose sur la machine ciblée.
kubernetes.core.k8s
Crée, met à jour ou supprime des ressources Kubernetes via l’API.
Exemple
kubernetes.core.k8s:
state: present
definition: "{{ lookup('file', 'manifests/web.yaml') | from_yaml }}"
Nécessite la collection, les dépendances Python et un kubeconfig autorisé.
04 · Méthode de mise en production
Un cas métier Ansible s’accompagne d’une méthode de contrôle, de retour arrière et de vérification du service.
Avant la modification
Réaliser l’inventaire, vérifier les droits, versionner le playbook et sauvegarder les fichiers importants.
Exemple
ansible-playbook -i inventory.ini site.yml --list-hosts
Contrôle de syntaxe
Valider la structure YAML et les références de modules.
Exemple
ansible-playbook -i inventory.ini site.yml --syntax-check
Simulation
Estimer les modifications et vérifier les différences sur un hôte de TP.
Exemple
ansible-playbook -i inventory.ini site.yml --limit web1 --check --diff
Un module peut ne pas annoncer toutes ses actions en check mode.
Déploiement progressif
Réaliser un premier déploiement sur un hôte pilote avant d’étendre aux autres.
Exemple
ansible-playbook -i inventory.ini site.yml --limit web1
Vérification métier
Tester le résultat fonctionnel en plus du récapitulatif Ansible.
Exemple
curl -I http://192.0.2.11/
Une tâche « ok » ne prouve pas la disponibilité de l’application.
Retour arrière
Prévoir le retour à une configuration connue, à une version d’image précédente et aux sauvegardes.
Exemple
git checkout <revision> puis relance contrôlée du playbook
Rollback du code et restauration des données sont deux opérations différentes.
05 · Cas métier A — Préparer une flotte de serveurs Linux
BESOIN : Un administrateur SysOps veut préparer plusieurs VM Ubuntu avec les mêmes outils, des droits et une arborescence de base.
PRÉREQUIS : Il faut disposer d’un accès SSH, d’un compte pouvant utiliser sudo et de dépôts APT joignables.
Réalisation · playbook 01-preparer-serveurs.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Preparations communes des serveurs Ubuntu
hosts: web
become: true
gather_facts: true
tasks:
- name: Verifier le systeme d'exploitation
ansible.builtin.assert:
that:
- ansible_facts['os_family'] == 'Debian'
fail_msg: "Ce cas vise Debian et Ubuntu."
- name: Mettre a jour le cache des paquets
ansible.builtin.apt:
update_cache: true
cache_valid_time: 3600
- name: Installer les outils d'exploitation
ansible.builtin.apt:
name: [curl, git, htop, ca-certificates]
state: present
- name: Creer un dossier applicatif
ansible.builtin.file:
path: /opt/portail
state: directory
mode: '0755'
À contrôler : Validation : apt list --installed, présence de /opt/portail. Limite : ne fonctionne pas tel quel sur RHEL.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 01-preparer-serveurs.yml --syntax-check
ansible-playbook -i inventory.ini 01-preparer-serveurs.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 01-preparer-serveurs.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
06 · Cas métier B — Publier un site web Nginx reproductible
BESOIN : Un responsable d’exploitation doit installer Nginx, publier une page HTML et créer un virtual host à partir de variables.
PRÉREQUIS : Installer le module apt, fournir files/index.html et templates/site.conf.j2, disposer d’un DNS ou de /etc/hosts adapté.
Réalisation · playbook 02-deployer-nginx.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Installer et configurer le serveur web
hosts: web
become: true
vars:
site_hostname: demo.example.test
tasks:
- name: Installer nginx
ansible.builtin.apt:
name: nginx
state: present
update_cache: true
- name: Deployer la page d'accueil
ansible.builtin.copy:
src: files/index.html
dest: /var/www/html/index.html
owner: root
group: root
mode: '0644'
- name: Generer le virtual host
ansible.builtin.template:
src: templates/site.conf.j2
dest: /etc/nginx/sites-available/demo
owner: root
group: root
mode: '0644'
notify: Recharger nginx
- name: Activer le site
ansible.builtin.file:
src: /etc/nginx/sites-available/demo
dest: /etc/nginx/sites-enabled/demo
state: link
notify: Recharger nginx
- name: Valider la configuration nginx
ansible.builtin.command: nginx -t
changed_when: false
- name: Demarrer nginx au boot
ansible.builtin.service:
name: nginx
state: started
enabled: true
handlers:
- name: Recharger nginx
ansible.builtin.service:
name: nginx
state: reloaded
À contrôler : Validation : nginx -t puis curl -H "Host: demo.example.test" http://IP_DU_SERVEUR/ ; prévoir la validation de conf avant rechargement en production.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 02-deployer-nginx.yml --syntax-check
ansible-playbook -i inventory.ini 02-deployer-nginx.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 02-deployer-nginx.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
Fichier associé : 02-site.conf.j2
Ressource complémentaire utilisée par le playbook. Conserver le nom et le chemin attendus, puis adapter les valeurs au TP.
Exemple
server {
listen 80;
server_name {{ site_hostname }};
root /var/www/html;
index index.html;
location / { try_files $uri $uri/ =404; }
}
Ces fichiers font également partie du ZIP des exemples.
Fichier associé : 02-index.html
Ressource complémentaire utilisée par le playbook. Conserver le nom et le chemin attendus, puis adapter les valeurs au TP.
Exemple
<!doctype html>
<html lang="fr"><meta charset="utf-8">
<title>Atelier Ansible</title><h1>Deploiement Ansible OK</h1>
Ces fichiers font également partie du ZIP des exemples.
07 · Cas métier C — Gérer les comptes et accès SSH
BESOIN : Une équipe d’exploitation crée un compte de déploiement unique et y associe une clé publique approuvée.
PRÉREQUIS : Préparer files/deploiement.pub ; installer ansible.posix depuis requirements.yml.
Réalisation · playbook 03-acces-ssh.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Creer un compte de deploiement
hosts: web
become: true
tasks:
- name: Creer le compte applicatif
ansible.builtin.user:
name: deploiement
shell: /bin/bash
create_home: true
state: present
- name: Installer sa cle publique
ansible.posix.authorized_key:
user: deploiement
key: "{{ lookup('file', 'files/deploiement.pub') }}"
state: present
À contrôler : Validation : ssh -i CHEMIN_CLE deploiement@IP ; ne jamais supprimer l’accès existant avant vérification du nouveau.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 03-acces-ssh.yml --syntax-check
ansible-playbook -i inventory.ini 03-acces-ssh.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 03-acces-ssh.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
08 · Cas métier D — Planifier les mises à jour par lots
BESOIN : Un administrateur doit appliquer les correctifs sur les serveurs web sans tous les interrompre simultanément.
PRÉREQUIS : Prévoir une fenêtre de maintenance, une sauvegarde et au moins une capacité applicative restante pendant serial: 1.
Réalisation · playbook 04-maintenance.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Maintenir les serveurs successivement
hosts: web
become: true
serial: 1
tasks:
- name: Installer les correctifs disponibles
ansible.builtin.apt:
update_cache: true
upgrade: safe
- name: Detecter un redemarrage demande par Ubuntu
ansible.builtin.stat:
path: /var/run/reboot-required
register: reboot_requis
- name: Redemarrer uniquement si necessaire
ansible.builtin.reboot:
reboot_timeout: 600
when: reboot_requis.stat.exists
À contrôler : Validation : versions des paquets et disponibilité applicative ; la stratégie de reboot doit être adaptée à l’exploitation.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 04-maintenance.yml --syntax-check
ansible-playbook -i inventory.ini 04-maintenance.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 04-maintenance.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
09 · Cas métier E — Déployer une application Docker Compose
BESOIN : Une équipe DevOps réutilise les connaissances Docker : Ansible copie le fichier Compose et assure le démarrage du service.
PRÉREQUIS : Docker Engine, plugin Compose V2 et community.docker installés sur leurs machines respectives.
Réalisation · playbook 05-docker-compose.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Deployer une application Docker Compose
hosts: web
become: true
tasks:
- name: Creer le dossier du projet
ansible.builtin.file:
path: /opt/portail
state: directory
mode: '0755'
- name: Publier compose.yaml
ansible.builtin.copy:
src: files/compose.yaml
dest: /opt/portail/compose.yaml
mode: '0644'
- name: Lancer la stack Compose
community.docker.docker_compose_v2:
project_src: /opt/portail
state: present
À contrôler : Validation : docker compose -f /opt/portail/compose.yaml ps ; HTTP sur le port 8080 si réseau autorisé.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 05-docker-compose.yml --syntax-check
ansible-playbook -i inventory.ini 05-docker-compose.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 05-docker-compose.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
Fichier associé : 05-compose.yaml
Ressource complémentaire utilisée par le playbook. Conserver le nom et le chemin attendus, puis adapter les valeurs au TP.
Exemple
services:
web:
image: nginx:stable-alpine
ports:
- "8080:80"
restart: unless-stopped
Ces fichiers font également partie du ZIP des exemples.
10 · Cas métier F — Déployer des objets Kubernetes
BESOIN : Une équipe Platform Engineering utilise Ansible pour appliquer un manifeste via l’API Kubernetes, sans commande kubectl shell.
PRÉREQUIS : Cluster accessible depuis le nœud de contrôle, kubeconfig autorisé, collection kubernetes.core et ses dépendances Python.
Réalisation · playbook 06-kubernetes.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Publier une ressource sur Kubernetes
hosts: localhost
gather_facts: false
tasks:
- name: Appliquer le manifeste YAML via l'API
kubernetes.core.k8s:
state: present
definition: "{{ lookup('file', 'manifests/web.yaml') | from_yaml }}"
À contrôler : Validation : kubectl get configmap demo-ansible ; ne jamais publier des secrets en clair.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 06-kubernetes.yml --syntax-check
ansible-playbook -i inventory.ini 06-kubernetes.yml --check
ansible-playbook -i inventory.ini 06-kubernetes.yml
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.
Fichier associé : 06-web.yaml
Ressource complémentaire utilisée par le playbook. Conserver le nom et le chemin attendus, puis adapter les valeurs au TP.
Exemple
apiVersion: v1
kind: ConfigMap
metadata:
name: demo-ansible
namespace: default
data:
MESSAGE: "Configuration geree par Ansible"
Ces fichiers font également partie du ZIP des exemples.
11 · Cas métier G — Auditer la conformité des serveurs
BESOIN : Un responsable SI veut prouver que le service Nginx est présent et actif sur un ensemble de nœuds.
PRÉREQUIS : Nginx installé sur la flotte et droits nécessaires pour consulter l’état des services.
Réalisation · playbook 07-audit.yml
Le playbook ci-dessous est directement copiable dans un fichier YAML. Identifier hosts, les modules appelés et les effets attendus avant l’exécution.
Exemple
---
- name: Observer la conformite des serveurs
hosts: web
become: true
tasks:
- name: Collecter les services
ansible.builtin.service_facts:
- name: Verifier que nginx est actif
ansible.builtin.assert:
that:
- "'nginx.service' in ansible_facts.services"
- "ansible_facts.services['nginx.service'].state == 'running'"
fail_msg: "Nginx ne fonctionne pas sur cet hote."
- name: Donner le bilan
ansible.builtin.debug:
msg: "Nginx actif sur {{ inventory_hostname }}"
À contrôler : Validation : output par hôte ; un audit est une photographie de l’état, non un système complet de supervision.
Commande de mise en œuvre
Vérifier le ciblage et la syntaxe, puis exécuter uniquement sur les machines ou le cluster de formation.
Exemple
ansible-playbook -i inventory.ini 07-audit.yml --syntax-check
ansible-playbook -i inventory.ini 07-audit.yml --limit web1 --check --diff
ansible-playbook -i inventory.ini 07-audit.yml --limit web1
Pour les cas qui utilisent localhost ou des modules ne simulant pas tout : ajuster les options et confirmer les prérequis. L’exemple D peut provoquer un redémarrage réel.