FR

Applications

Automatiser ses serveurs avec Ansible

Débutez avec Ansible : installation, inventaire, playbook, rôles et chiffrement des secrets avec Ansible Vault pour vos serveurs Debian et Ubuntu.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ansible permet de décrire la configuration de vos serveurs dans des fichiers YAML, puis de l’appliquer par SSH. Aucun agent n’est à installer sur les serveurs administrés : il leur faut seulement SSH et Python.

Dans ce guide, vous allez créer un petit projet qui installe Nginx, publie une page de démonstration et dépose un secret chiffré avec Ansible Vault.

Terme Signification
Nœud de contrôle Machine où Ansible est installé et d’où vous lancez les commandes
Nœud géré Serveur administré par Ansible
Inventaire Liste des serveurs et de leurs groupes
Tâche Action unitaire, confiée à un module
Playbook Fichier YAML qui associe des tâches à des serveurs
Rôle Ensemble réutilisable de tâches, modèles et variables
Vault Mécanisme de chiffrement des données sensibles

Prérequis

  • Un nœud de contrôle sous Linux : votre poste ou un serveur d’administration
  • Un ou plusieurs serveurs gérés sous Debian 12/13 ou Ubuntu 22.04/24.04
  • Un utilisateur SSH sur chaque serveur géré, membre du groupe sudo
  • Une authentification SSH par clé
  • Le port SSH accessible depuis le nœud de contrôle, et le port 80 pour la page de démonstration

Choisir le nœud de contrôle

La version d’Ansible disponible dépend de celle de Python sur le nœud de contrôle :

Système du nœud de contrôle Python Version installée par pipx État
Debian 13 3.13 Ansible 15 (ansible-core 2.22) Recommandé
Ubuntu 24.04 3.12 Ansible 14 (ansible-core 2.21) Recommandé
Debian 12 3.11 Ansible 12 (ansible-core 2.19) Fin de vie en novembre 2026
Ubuntu 22.04 3.10 Ansible 10 (ansible-core 2.17) Fin de vie

Cette contrainte concerne le nœud de contrôle. Debian 12 et Ubuntu 22.04 restent utilisables comme serveurs gérés.

Installer Ansible

Sur le nœud de contrôle, installez Ansible avec pipx, une méthode décrite dans la documentation officielle :

Terminal
sudo apt update
sudo apt install -y pipx
pipx ensurepath

Fermez puis rouvrez votre session pour prendre en compte le PATH, puis installez le paquet complet :

Terminal
pipx install --include-deps ansible
ansible --version

Préparer l’accès SSH

Créez une clé si vous n’en avez pas, puis copiez-la sur le serveur géré :

Terminal
ssh-keygen -t ed25519 -C "ansible"
ssh-copy-id VOTRE_USER@IP_SERVEUR
ssh -t VOTRE_USER@IP_SERVEUR 'python3 --version && sudo -v'

La première connexion vous demande de confirmer l’empreinte du serveur : vérifiez-la, car Ansible refusera ensuite un hôte inconnu. Pour durcir l’accès SSH, consultez le guide Sécuriser son serveur.

Créer le projet

Terminal
mkdir -p ~/infra/group_vars/web
cd ~/infra
nano ansible.cfg
Configuration
[defaults]
inventory = inventory.ini
roles_path = roles

Écrire l’inventaire

Terminal
nano inventory.ini
Configuration
[web]
web1 ansible_host=IP_SERVEUR ansible_user=VOTRE_USER

Si votre port SSH n’est pas 22, ajoutez ansible_port=VOTRE_PORT sur la ligne du serveur. Contrôlez ensuite l’inventaire et la connexion :

Terminal
ansible-inventory --graph
ansible all -m ansible.builtin.ping
ansible web -m ansible.builtin.command -a "uptime"

Le module ping doit répondre pong. Il vérifie la connexion SSH et Python : ce n’est pas un ping réseau.

Écrire un premier playbook

Terminal
nano premier-playbook.yml
YAML
---
- name: Préparer les serveurs web
  hosts: web
  become: true
  tasks:
    - name: Installer Nginx
      ansible.builtin.apt:
        name: nginx
        state: present
        update_cache: true
        cache_valid_time: 3600

    - name: Activer et démarrer Nginx
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true

become: true exécute les tâches avec sudo. Testez d’abord sans rien modifier, puis appliquez :

Terminal
ansible-playbook premier-playbook.yml --check --diff
ansible-playbook premier-playbook.yml

Ajoutez --ask-become-pass si sudo demande un mot de passe. Relancez ensuite le playbook : le récapitulatif doit indiquer changed=0, car l’état voulu est déjà atteint. C’est le principe d’idempotence.

Organiser le code avec un rôle

Générez la structure d’un rôle nommé web :

Terminal
ansible-galaxy role init --init-path roles web

Variables par défaut

Fichier roles/web/defaults/main.yml :

YAML
---
web_domain: votre-domaine.com
web_root: /var/www/demo
app_config_dir: /etc/demo-app

Tâches

Fichier roles/web/tasks/main.yml :

YAML
---
- name: Installer Nginx
  ansible.builtin.apt:
    name: nginx
    state: present
    update_cache: true
    cache_valid_time: 3600

- name: Créer le dossier du site
  ansible.builtin.file:
    path: "{{ web_root }}"
    state: directory
    owner: root
    group: root
    mode: "0755"

- name: Publier la page de démonstration
  ansible.builtin.copy:
    dest: "{{ web_root }}/index.html"
    content: "<h1>Serveur géré par Ansible : {{ inventory_hostname }}</h1>\n"
    owner: root
    group: root
    mode: "0644"

- name: Déployer la configuration du site
  ansible.builtin.template:
    src: site.conf.j2
    dest: /etc/nginx/sites-available/demo.conf
    owner: root
    group: root
    mode: "0644"
  notify: Recharger Nginx

- name: Activer le site
  ansible.builtin.file:
    src: /etc/nginx/sites-available/demo.conf
    dest: /etc/nginx/sites-enabled/demo.conf
    state: link
  notify: Recharger Nginx

- name: Créer le dossier de configuration de l'application
  ansible.builtin.file:
    path: "{{ app_config_dir }}"
    state: directory
    owner: root
    group: root
    mode: "0750"

- name: Déposer le secret de l'application
  ansible.builtin.copy:
    dest: "{{ app_config_dir }}/app.env"
    content: "APP_TOKEN={{ app_token }}\n"
    owner: root
    group: root
    mode: "0600"
  no_log: true

- name: Activer et démarrer Nginx
  ansible.builtin.service:
    name: nginx
    state: started
    enabled: true

no_log: true empêche le secret d’apparaître dans la sortie d’Ansible.

Gestionnaire

Fichier roles/web/handlers/main.yml. Un gestionnaire ne s’exécute que si une tâche l’a notifié, une seule fois, à la fin de la série de tâches :

YAML
---
- name: Recharger Nginx
  ansible.builtin.service:
    name: nginx
    state: reloaded

Modèle Jinja2

Fichier roles/web/templates/site.conf.j2 :

Nginx
server {
    listen 80;
    listen [::]:80;
    server_name {{ web_domain }};
    root {{ web_root }};
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Playbook principal

Fichier site.yml, à la racine du projet :

YAML
---
- name: Configurer les serveurs web
  hosts: web
  become: true
  roles:
    - web

Protéger les secrets avec Ansible Vault

Séparez les variables ordinaires des variables chiffrées. Le fichier group_vars/web/vars.yml reste lisible et référence le secret :

YAML
---
app_token: "{{ vault_app_token }}"

Créez le fichier chiffré. Choisissez un mot de passe solide lorsque la commande le demande :

Terminal
EDITOR=nano ansible-vault create group_vars/web/vault.yml

Écrivez-y le secret :

YAML
---
vault_app_token: "REMPLACEZ_PAR_VOTRE_SECRET"

Une fois enregistré, le fichier commence par $ANSIBLE_VAULT et son contenu est illisible. Les commandes utiles sont :

Commande Effet
ansible-vault view group_vars/web/vault.yml Afficher le contenu
ansible-vault edit group_vars/web/vault.yml Modifier le contenu
ansible-vault rekey group_vars/web/vault.yml Changer le mot de passe

Lancer le déploiement

Autorisez le trafic web sur le serveur géré si UFW est actif, puis lancez une simulation et le déploiement :

Terminal
ssh -t VOTRE_USER@IP_SERVEUR 'sudo ufw allow 80/tcp'
ansible-playbook site.yml --syntax-check --ask-vault-pass
ansible-playbook site.yml --check --diff --ask-vault-pass
ansible-playbook site.yml --ask-vault-pass

Pour automatiser, conservez le mot de passe dans un fichier hors du projet :

Terminal
install -m 600 /dev/null ~/.ansible-vault-infra
nano ~/.ansible-vault-infra
ansible-playbook site.yml --vault-password-file ~/.ansible-vault-infra

Vérifier le résultat

Terminal
curl -H 'Host: votre-domaine.com' http://IP_SERVEUR/
ansible web -b -m ansible.builtin.stat -a "path=/etc/demo-app/app.env"
ansible-playbook site.yml --ask-vault-pass

La page doit afficher le nom web1, le fichier app.env doit avoir le mode 0600, et le dernier passage doit se terminer par changed=0.

Cette page de démonstration est servie en HTTP. Pour un vrai site, ajoutez un certificat en suivant le guide Installer un certificat SSL avec Let’s Encrypt.

Versionner et sauvegarder le projet

Ansible ne conserve pas d’état : votre projet est la référence. Placez-le dans un dépôt Git privé et excluez les fichiers locaux :

Terminal
cd ~/infra
git init
printf '%s\n' '*.retry' '.vault-pass*' > .gitignore
git add .
git status
git commit -m "Projet Ansible initial"

Avant le premier commit, vérifiez que group_vars/web/vault.yml est bien chiffré :

Terminal
head -n 1 group_vars/web/vault.yml

Sauvegardez le mot de passe Vault dans un gestionnaire de mots de passe, séparément du dépôt : sans lui, les secrets sont irrécupérables.

Mettre à jour Ansible

Terminal
pipx upgrade --include-injected ansible
ansible --version

Si vous utilisez le PPA, passez par sudo apt update puis sudo apt install --only-upgrade ansible. Après une mise à jour majeure, consultez le guide de portage et relancez vos playbooks avec --check --diff.

En cas de problème

ansible: command not found

Le dossier de pipx n’est pas dans le PATH. Exécutez pipx ensurepath, puis ouvrez une nouvelle session.

UNREACHABLE et Permission denied (publickey,password)

Testez la connexion avec les mêmes paramètres, puis relancez Ansible en mode détaillé :

Terminal
ssh -p 22 VOTRE_USER@IP_SERVEUR
ansible all -m ansible.builtin.ping -vvv

Vérifiez ansible_host, ansible_user, ansible_port et la clé utilisée.

Host key verification failed

L’empreinte du serveur est inconnue ou a changé. Après une réinstallation légitime, supprimez l’ancienne entrée, puis reconnectez-vous et vérifiez la nouvelle empreinte :

Terminal
ssh-keygen -R IP_SERVEUR
ssh VOTRE_USER@IP_SERVEUR

Missing sudo password

Ajoutez --ask-become-pass, ou configurez sudo selon votre politique de sécurité.

Attempting to decrypt but no vault secrets found

Le playbook lit un fichier chiffré sans mot de passe. Ajoutez --ask-vault-pass ou --vault-password-file.

Decryption failed

Le mot de passe ne correspond pas à celui du fichier. Vérifiez aussi que le fichier de mot de passe ne contient pas une autre valeur.

Could not get lock /var/lib/dpkg/lock-frontend

Une autre opération APT est en cours, souvent les mises à jour automatiques. Attendez la fin de l’opération, ou ajoutez lock_timeout: 300 à la tâche ansible.builtin.apt.

Ansible ignore ansible.cfg

Ansible ignore ce fichier si le dossier courant est accessible en écriture à tous. Corrigez les droits avec chmod o-w ~/infra, puis contrôlez le résultat avec ansible --version, qui indique le fichier chargé.

Pour aller plus loin

Pour créer l’infrastructure ou générer des fichiers avant de la configurer, consultez le guide Débuter avec Terraform. Pour centraliser vos secrets, consultez Installer HashiCorp Vault.

Références