Cours en ligne

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

Terraform & Ansible — Le cours

Guide 08 / 3

Commandes Ansible

Retrouver les commandes opérationnelles et leurs options pour travailler avec précaution sur des serveurs.

Résultat attendu :

Tester l’accès, cibler les hôtes, simuler, appliquer et diagnostiquer un playbook Ansible.

Lecture
0%

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.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install ansible
À retenir :

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.

ansible --version

ansible-config dump --only-changed

Affiche les paramètres qui diffèrent des valeurs par défaut.

ansible-config dump --only-changed

ansible-config view

Affiche le contenu du fichier de configuration chargé.

ansible-config view

ansible-doc -l

Liste les modules et plugins documentés disponibles.

ansible-doc -l | grep ansible.builtin.apt

ansible-doc [module]

Ouvre la documentation détaillée et les paramètres d’un module.

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.

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.

ansible-inventory -i inventory.ini --list
À retenir :

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.

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.

ansible web -i inventory.ini -m ansible.builtin.ping
À retenir :

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.

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.

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

Sélectionner le compte (-u)

Indique le compte de connexion SSH.

ansible web -i inventory.ini -m ping -u deployer

Choisir une clé SSH (--private-key)

Désigne une clé privée SSH particulière.

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.

ansible web -i inventory.ini -m ping -k
À retenir :

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.

ansible web -i inventory.ini -a "whoami"
À retenir :

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

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.

ansible web -i inventory.ini -b -m ansible.builtin.apt -a "name=curl state=present"
À retenir :

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.

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.

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.

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.

ansible web -i inventory.ini -m ansible.builtin.shell -a "df -h | tail -n 3"
À retenir :

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.

ansible-playbook -i inventory.ini site.yml

--syntax-check

Analyse la structure et la syntaxe du playbook sans exécuter les tâches.

ansible-playbook -i inventory.ini site.yml --syntax-check
À retenir :

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.

ansible-playbook -i inventory.ini site.yml --check

--diff

Affiche les écarts de fichiers et de templates lorsque les modules le prennent en charge.

ansible-playbook -i inventory.ini site.yml --check --diff

--list-hosts

Liste les cibles du playbook avant son exécution.

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

--list-tasks

Affiche les tâches du playbook connues avant exécution.

ansible-playbook -i inventory.ini site.yml --list-tasks
À retenir :

Les inclusions dynamiques ne sont pas toujours visibles à ce stade.

--tags / --skip-tags

Exécute uniquement certains groupes de tâches ou en exclut d’autres.

ansible-playbook site.yml --tags nginx

--start-at-task

Reprend à partir d’une tâche nommée.

ansible-playbook site.yml --start-at-task "Installer nginx"
À retenir :

Ne remplace pas la validation des prérequis des étapes précédentes.

--step

Demande une confirmation interactive avant chaque tâche.

ansible-playbook site.yml --step

-b / -K

Active become et, avec -K, demande le mot de passe d’élévation si nécessaire.

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.

ansible-playbook site.yml -e "env=staging"
À retenir :

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.

ansible-playbook -i inventory.ini site.yml -vvv
À retenir :

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.

ansible-galaxy collection list

ansible-galaxy collection install

Installe une collection additionnelle.

ansible-galaxy collection install community.docker

Installer des collections via requirements.yml

Installe les dépendances listées dans le dépôt.

ansible-galaxy collection install -r requirements.yml

ansible-galaxy role init

Crée l’arborescence standard d’un rôle.

ansible-galaxy role init roles/nginx

ansible-vault create

Crée un fichier YAML chiffré et l’ouvre dans un éditeur.

ansible-vault create group_vars/prod/vault.yml

ansible-vault encrypt

Chiffre un fichier existant.

ansible-vault encrypt group_vars/prod/vault.yml

ansible-vault edit

Ouvre un fichier chiffré pour le modifier sans conserver une copie en clair.

ansible-vault edit group_vars/prod/vault.yml

ansible-vault rekey

Renouvelle le mot de passe de chiffrement d’un fichier Vault.

ansible-vault rekey group_vars/prod/vault.yml

--ask-vault-pass

Demande le mot de passe Vault lors d’une exécution.

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.

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.

Vérifier IP, SSH, clé, utilisateur et pare-feu.

failed

Une tâche a été exécutée mais a échoué.

Vérifier le message détaillé, les permissions et les prérequis.

ansible-config dump

Affiche les valeurs de configuration effectives.

ansible-config dump | grep DEFAULT_TIMEOUT

ansible-playbook --help

Affiche l’aide générale des options en ligne de commande.

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.

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

Les modules qui ne prennent pas en charge le check mode peuvent limiter la portée du contrôle.