Guide 08 / 3
Commandes Ansible
Retrouver les commandes opérationnelles et leurs options pour travailler avec précaution sur des serveurs.
Tester l’accès, cibler les hôtes, simuler, appliquer et diagnostiquer un playbook Ansible.
01 · Installer et vérifier
Depuis une machine Linux de contrôle : isoler les dépendances du projet et vérifier la configuration active.
Créer un environnement Python
Évite de modifier les paquets Python du système et isole Ansible pour le projet.
Exemple
python3 -m venv .venv
source .venv/bin/activate
python -m pip install ansible
La commande source est destinée à bash/zsh ; sur Windows utiliser un environnement compatible.
ansible --version
Indique la version de l’outil, le Python employé et le chemin d’ansible.cfg.
Exemple
ansible --version
ansible-config dump --only-changed
Affiche les paramètres qui diffèrent des valeurs par défaut.
Exemple
ansible-config dump --only-changed
ansible-config view
Affiche le contenu du fichier de configuration chargé.
Exemple
ansible-config view
ansible-doc -l
Liste les modules et plugins documentés disponibles.
Exemple
ansible-doc -l | grep ansible.builtin.apt
ansible-doc [module]
Ouvre la documentation détaillée et les paramètres d’un module.
Exemple
ansible-doc ansible.builtin.template
02 · Inventaire, cibles et connectivité
Commencer par visualiser les hôtes ciblés et tester leur accessibilité avant une intervention.
ansible-inventory --graph
Montre la structure des groupes de l’inventaire.
Exemple
ansible-inventory -i inventory.ini --graph
ansible-inventory --list
Produit la vue complète de l’inventaire, avec variables, telle qu’Ansible l’interprète.
Exemple
ansible-inventory -i inventory.ini --list
La sortie peut inclure des informations sensibles présentes dans l’inventaire.
ansible [groupe] --list-hosts
Affiche les hôtes correspondant au ciblage sans lancer de module distant.
Exemple
ansible web -i inventory.ini --list-hosts
ansible [groupe] -m ping
Teste l’accès et l’exécution d’un module Python sur les hôtes.
Exemple
ansible web -i inventory.ini -m ansible.builtin.ping
Ce ping n’est pas un paquet ICMP : il nécessite l’authentification et Python côté cible.
ansible [groupe] -m setup
Récupère les faits système d’un ou plusieurs serveurs.
Exemple
ansible web -i inventory.ini -m ansible.builtin.setup
Cibler un seul hôte avec --limit
Restreint un groupe ou une exécution à un sous-ensemble.
Exemple
ansible-playbook -i inventory.ini site.yml --limit web1
Sélectionner le compte (-u)
Indique le compte de connexion SSH.
Exemple
ansible web -i inventory.ini -m ping -u deployer
Choisir une clé SSH (--private-key)
Désigne une clé privée SSH particulière.
Exemple
ansible web -i inventory.ini -m ping --private-key ~/.ssh/id_ed25519
Demander le mot de passe (-k)
Invite à renseigner un mot de passe pour la connexion.
Exemple
ansible web -i inventory.ini -m ping -k
Préférer les clés SSH sur les environnements gérés.
03 · Commandes ponctuelles (ad hoc)
Pour une vérification ou une action simple, une commande ansible peut lancer un module sans créer de playbook.
Afficher l’identité distante
Lance le module command pour connaître le compte exécutant la commande.
Exemple
ansible web -i inventory.ini -a "whoami"
-a sans -m explicite utilise ansible.builtin.command par défaut.
Tester une présence de paquet
Interroge les paquets présents avec package_facts, sans les modifier.
Exemple
ansible web -i inventory.ini -m ansible.builtin.package_facts
Installer un paquet avec apt
Demande l’installation d’un paquet sur une cible Debian/Ubuntu.
Exemple
ansible web -i inventory.ini -b -m ansible.builtin.apt -a "name=curl state=present"
Action modifiante : commencer par --limit web1 et un environnement de TP.
Créer un dossier
Assure qu’un répertoire existe et possède des permissions données.
Exemple
ansible web -i inventory.ini -b -m ansible.builtin.file -a "path=/opt/demo state=directory mode=0755"
Consulter l’état d’un service
Collecte les informations de services sans imposer un changement.
Exemple
ansible web -i inventory.ini -b -m ansible.builtin.service_facts
ansible [groupe] -m command
Exécute un programme distant sans interprétation par un shell.
Exemple
ansible web -i inventory.ini -m ansible.builtin.command -a "uptime"
ansible [groupe] -m shell
Exécute une chaîne via un shell distant, utile pour les pipes ou redirections.
Exemple
ansible web -i inventory.ini -m ansible.builtin.shell -a "df -h | tail -n 3"
Le shell augmente les risques d’injection et d’absence d’idempotence ; limiter son usage.
04 · Lire, contrôler et exécuter les playbooks
Ordre recommandé : identifier les hôtes, valider la syntaxe, simuler, examiner les différences, puis appliquer.
ansible-playbook -i ...
Lance le playbook sur les cibles de l’inventaire.
Exemple
ansible-playbook -i inventory.ini site.yml
--syntax-check
Analyse la structure et la syntaxe du playbook sans exécuter les tâches.
Exemple
ansible-playbook -i inventory.ini site.yml --syntax-check
Ne garantit ni la connectivité, ni les permissions, ni la réussite métier.
--check
Essaie de simuler les modifications d’un playbook sans les appliquer.
Exemple
ansible-playbook -i inventory.ini site.yml --check
--diff
Affiche les écarts de fichiers et de templates lorsque les modules le prennent en charge.
Exemple
ansible-playbook -i inventory.ini site.yml --check --diff
--list-hosts
Liste les cibles du playbook avant son exécution.
Exemple
ansible-playbook -i inventory.ini site.yml --list-hosts
--list-tasks
Affiche les tâches du playbook connues avant exécution.
Exemple
ansible-playbook -i inventory.ini site.yml --list-tasks
Les inclusions dynamiques ne sont pas toujours visibles à ce stade.
--start-at-task
Reprend à partir d’une tâche nommée.
Exemple
ansible-playbook site.yml --start-at-task "Installer nginx"
Ne remplace pas la validation des prérequis des étapes précédentes.
--step
Demande une confirmation interactive avant chaque tâche.
Exemple
ansible-playbook site.yml --step
-b / -K
Active become et, avec -K, demande le mot de passe d’élévation si nécessaire.
Exemple
ansible-playbook -i inventory.ini site.yml -b -K
-e (extra-vars)
Fournit une variable qui a une priorité élevée sur les autres définitions.
Exemple
ansible-playbook site.yml -e "env=staging"
Ne pas écrire des secrets en clair dans l’historique de commande.
-v / -vvv
Affiche un niveau croissant de détails pour comprendre les échecs.
Exemple
ansible-playbook -i inventory.ini site.yml -vvv
Les traces détaillées peuvent divulguer des paramètres ; manier avec précaution.
05 · Rôles, collections et secrets
Le travail en équipe suppose de documenter les dépendances et de protéger les variables confidentielles.
ansible-galaxy collection list
Liste les collections installées et leur version.
Exemple
ansible-galaxy collection list
ansible-galaxy collection install
Installe une collection additionnelle.
Exemple
ansible-galaxy collection install community.docker
Installer des collections via requirements.yml
Installe les dépendances listées dans le dépôt.
Exemple
ansible-galaxy collection install -r requirements.yml
ansible-galaxy role init
Crée l’arborescence standard d’un rôle.
Exemple
ansible-galaxy role init roles/nginx
ansible-vault create
Crée un fichier YAML chiffré et l’ouvre dans un éditeur.
Exemple
ansible-vault create group_vars/prod/vault.yml
ansible-vault encrypt
Chiffre un fichier existant.
Exemple
ansible-vault encrypt group_vars/prod/vault.yml
ansible-vault edit
Ouvre un fichier chiffré pour le modifier sans conserver une copie en clair.
Exemple
ansible-vault edit group_vars/prod/vault.yml
ansible-vault rekey
Renouvelle le mot de passe de chiffrement d’un fichier Vault.
Exemple
ansible-vault rekey group_vars/prod/vault.yml
--ask-vault-pass
Demande le mot de passe Vault lors d’une exécution.
Exemple
ansible-playbook site.yml --ask-vault-pass
06 · Diagnostiquer et exploiter
Face à un échec, confirmer la cible, l’accès, le module utilisé et la partie précise de la tâche en erreur.
PLAY RECAP
Résumé final par hôte : ok, changed, unreachable, failed, skipped, rescued, ignored.
Exemple
failed=0 et unreachable=0 : pas d’erreur détectée pendant l’exécution.
unreachable
Ansible n’a pas pu établir une connexion exploitable avec l’hôte.
Exemple
Vérifier IP, SSH, clé, utilisateur et pare-feu.
failed
Une tâche a été exécutée mais a échoué.
Exemple
Vérifier le message détaillé, les permissions et les prérequis.
ansible-config dump
Affiche les valeurs de configuration effectives.
Exemple
ansible-config dump | grep DEFAULT_TIMEOUT
ansible-playbook --help
Affiche l’aide générale des options en ligne de commande.
Exemple
ansible-playbook --help
Contrôler les écarts sans déployer
Repasser le playbook en --check --diff après une intervention pour détecter une dérive.
Exemple
ansible-playbook -i inventory.ini site.yml --check --diff
Les modules qui ne prennent pas en charge le check mode peuvent limiter la portée du contrôle.