Cours en ligne

Cours, TP et AkadéMOOC gratuits, avec votre progression.

Terraform & Ansible — Le cours

Guide 09 / 3

Configuration Ansible et cas métier

Comprendre les fichiers du projet, les modules et sept scénarios d’automatisation directement exploitables.

Résultat attendu :

Adapter un projet Ansible pour des serveurs Linux, Nginx, SSH, Docker Compose et Kubernetes.

Lecture
0%

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.

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.

[defaults]
inventory = inventory.ini
host_key_checking = True
À retenir :

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.

[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.

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.

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.

- hosts: web
À retenir :

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.

- name: Configurer nginx

become / become_user

Permet d’exécuter des tâches avec les permissions d’un autre compte, souvent root via sudo.

become: true
become_user: root

tasks / handlers

tasks contient les opérations à effectuer ; handlers les opérations déclenchées uniquement après changement.

notify: Recharger nginx

vars / vars_files

Définit des variables directement dans le play ou charge un fichier de variables.

vars:
  http_port: 8080

when

Condition d’exécution calculée pour chaque hôte.

when: ansible_facts["os_family"] == "Debian"

loop

Parcourt une liste et expose chaque élément dans item.

loop:
  - curl
  - git

register

Enregistre la réponse d’un module et permet de tester changed, failed ou stdout.

register: resultat

notify

Demande l’exécution différée d’un handler si la tâche notifiée a changé quelque chose.

notify: Recharger nginx

serial

Limite le nombre d’hôtes traités simultanément au sein d’un play.

serial: 1

check_mode / changed_when

Ajuste le comportement du mode vérification ou la détection de modification dans des cas précis.

changed_when: false pour une commande d’observation
À retenir :

É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.

no_log: true
À retenir :

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é.

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.

ansible.builtin.package:
  name: curl
  state: present

ansible.builtin.file

Gère dossiers, permissions, liens et suppressions de chemins.

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.

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.

ansible.builtin.template:
  src: templates/site.conf.j2
  dest: /etc/nginx/sites-available/site
  backup: true
À retenir :

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.

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.

ansible.builtin.user:
  name: deploiement
  state: present

ansible.posix.authorized_key

Gère une clé publique SSH autorisée pour un compte distant.

ansible.posix.authorized_key:
  user: deploiement
  key: "{{ lookup('file', 'files/deploiement.pub') }}"
À retenir :

Ce module appartient à ansible.posix : installer la collection correspondante.

community.docker.docker_compose_v2

Pilote les services d’un dossier Compose via le plugin Docker Compose V2 disponible sur l’hôte.

community.docker.docker_compose_v2:
  project_src: /opt/portail
  state: present
À retenir :

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.

kubernetes.core.k8s:
  state: present
  definition: "{{ lookup('file', 'manifests/web.yaml') | from_yaml }}"
À retenir :

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.

ansible-playbook -i inventory.ini site.yml --list-hosts

Contrôle de syntaxe

Valider la structure YAML et les références de modules.

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.

ansible-playbook -i inventory.ini site.yml --limit web1 --check --diff
À retenir :

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.

ansible-playbook -i inventory.ini site.yml --limit web1

Vérification métier

Tester le résultat fonctionnel en plus du récapitulatif Ansible.

curl -I http://192.0.2.11/
À retenir :

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.

git checkout <revision> puis relance contrôlée du playbook
À retenir :

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.

---
- 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'
À retenir :

À 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.

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
À retenir :

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.

---
- 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
À retenir :

À 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.

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
À retenir :

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.

server {
    listen 80;
    server_name {{ site_hostname }};
    root /var/www/html;
    index index.html;
    location / { try_files $uri $uri/ =404; }
}
À retenir :

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.

<!doctype html>
<html lang="fr"><meta charset="utf-8">
<title>Atelier Ansible</title><h1>Deploiement Ansible OK</h1>
À retenir :

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.

---
- 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
À retenir :

À 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.

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
À retenir :

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.

---
- 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
À retenir :

À 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.

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
À retenir :

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.

---
- 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
À retenir :

À 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.

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
À retenir :

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.

services:
  web:
    image: nginx:stable-alpine
    ports:
      - "8080:80"
    restart: unless-stopped
À retenir :

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.

---
- 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 }}"
À retenir :

À 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.

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
À retenir :

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.

apiVersion: v1
kind: ConfigMap
metadata:
  name: demo-ansible
  namespace: default
data:
  MESSAGE: "Configuration geree par Ansible"
À retenir :

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.

---
- 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 }}"
À retenir :

À 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.

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
À retenir :

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.