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.
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 :
sudo apt update
sudo apt install -y pipx
pipx ensurepathFermez puis rouvrez votre session pour prendre en compte le PATH, puis installez le paquet complet :
pipx install --include-deps ansible
ansible --versionPréparer l’accès SSH
Créez une clé si vous n’en avez pas, puis copiez-la sur le serveur géré :
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
mkdir -p ~/infra/group_vars/web
cd ~/infra
nano ansible.cfg[defaults]
inventory = inventory.ini
roles_path = rolesÉcrire l’inventaire
nano inventory.ini[web]
web1 ansible_host=IP_SERVEUR ansible_user=VOTRE_USERSi 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 :
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
nano premier-playbook.yml---
- 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: truebecome: true exécute les tâches avec sudo. Testez d’abord sans rien modifier, puis appliquez :
ansible-playbook premier-playbook.yml --check --diff
ansible-playbook premier-playbook.ymlAjoutez --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 :
ansible-galaxy role init --init-path roles webVariables par défaut
Fichier roles/web/defaults/main.yml :
---
web_domain: votre-domaine.com
web_root: /var/www/demo
app_config_dir: /etc/demo-appTâches
Fichier roles/web/tasks/main.yml :
---
- 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: trueno_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 :
---
- name: Recharger Nginx
ansible.builtin.service:
name: nginx
state: reloadedModèle Jinja2
Fichier roles/web/templates/site.conf.j2 :
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 :
---
- name: Configurer les serveurs web
hosts: web
become: true
roles:
- webProté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 :
---
app_token: "{{ vault_app_token }}"Créez le fichier chiffré. Choisissez un mot de passe solide lorsque la commande le demande :
EDITOR=nano ansible-vault create group_vars/web/vault.ymlÉcrivez-y le secret :
---
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 :
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-passPour automatiser, conservez le mot de passe dans un fichier hors du projet :
install -m 600 /dev/null ~/.ansible-vault-infra
nano ~/.ansible-vault-infra
ansible-playbook site.yml --vault-password-file ~/.ansible-vault-infraVérifier le résultat
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-passLa 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 :
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é :
head -n 1 group_vars/web/vault.ymlSauvegardez 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
pipx upgrade --include-injected ansible
ansible --versionSi 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é :
ssh -p 22 VOTRE_USER@IP_SERVEUR
ansible all -m ansible.builtin.ping -vvvVé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 :
ssh-keygen -R IP_SERVEUR
ssh VOTRE_USER@IP_SERVEURMissing 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.