Ansible cmd

Fiche express
Type	Référence de commandes
Portée	Exécution ad-hoc (ponctuelle), hors playbook
Syntaxe	ansible <motif> -i <inventaire> -m <module> -a "<args>"
Voir aussi	Ansible · Ansible easystart

Les commandes ad-hoc d'Ansible exécutent une action ponctuelle sur un ou plusieurs hôtes, sans écrire de playbook. Utile pour un correctif rapide ou un diagnostic ; pour toute action répétable ou versionnée, préférer un playbook (voir Ansible easystart).

Syntaxe générale

ansible <motif-hôtes> -i <inventaire> -m <module> -a "<arguments-du-module>"

• -i : fichier d'inventaire (sinon /etc/ansible/hosts)
• -m : module à exécuter (command par défaut si omis)
• -a : arguments passés au module
• -b : bascule en privilèges élevés (become / sudo)
• -u : utilisateur SSH à utiliser

Exemples

# Installer un paquet sur le groupe "remote"
ansible -i inventaire remote -m yum -a "name=elinks state=installed"

# Idem avec élévation de privilèges (become)
ansible -i inventaire centos -b -m yum -a "name=elinks state=installed"

# Mettre à jour vers la dernière version
ansible webservers -b -m yum -a "name=httpd state=latest"

# Test de connectivité (sans toucher aux hôtes)
ansible all -m ping

# Commande shell arbitraire
ansible webservers -b -m shell -a "systemctl restart httpd"

# Copier un fichier
ansible webservers -b -m copy -a "src=/local/fichier.conf dest=/etc/app/fichier.conf"

# Lister les facts collectés
ansible webservers -m setup

Exécuter un playbook

La commande ansible-playbook exécute un fichier de playbook :

ansible-playbook -i inventaire /chemin/vers/playbook.yml

Voir aussi

• Ansible — concepts, inventaire, variables
• Ansible easystart — premier playbook pas à pas
• Ansible tower — exécution planifiée et supervisée via interface web