0Pricing
Ansible Academy · Leçon

Explorer les faits avec le module setup

Affichez et parcourez l’arbre des faits d’un hôte.

Explorer les faits avec le module setup est une leçon Ansible Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Ansible Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Ansible Academy comprend 4 leçons au total.

Le collecteur de faits

L'étape cachée de collecte des faits est en réalité effectuée par un seul module : le module setup. Vous pouvez l'appeler vous-même pour l'explorer. 🌟

Exécuter setup ponctuellement

Dirigez une commande ponctuelle vers un hôte avec -m setup pour afficher tout son arbre de faits directement dans votre terminal.

ansible host1 -m setup

Il renvoie du JSON

La sortie est un grand objet JSON situé sous ansible_facts. Chaque clé correspond à un fait que vous pourrez ensuite utiliser dans un playbook.

"ansible_facts": {
  "distribution": "Ubuntu"
}

Cela fait beaucoup

Un affichage complet peut contenir des centaines de lignes. Pour trouver ce dont vous avez besoin, vous pouvez filtrer les faits au lieu de tout parcourir.

Filtrer par motif

Le module setup accepte un argument filter. Transmettez un motif glob et il ne renverra que les clés de faits correspondantes.

ansible host1 -m setup -a "filter=ansible_distribution*"

Faits courants à rechercher

Parmi les clés utiles figurent ansible_distribution, ansible_os_family, ansible_memtotal_mb et ansible_default_ipv4 pour le réseau.

Faits réseau imbriqués

Certains faits sont imbriqués. L'IP principale de l'hôte se trouve dans ansible_default_ipv4, sous une clé address à laquelle vous accédez en profondeur.

ansible_default_ipv4:
  address: 10.0.0.5

setup dans un playbook

Vous pouvez également ajouter setup comme tâche pour collecter à nouveau les faits au milieu d'un play, ce qui est utile après une modification de l'hôte.

- name: Refresh facts
  ansible.builtin.setup:

Limiter les données collectées

L'option gather_subset restreint la collecte, par exemple aux seuls faits réseau, afin que setup s'exécute plus rapidement lorsque vous n'avez besoin que d'une partie des données.

- ansible.builtin.setup:
    gather_subset:
      - network

Explorez avant de construire

Exécuter setup au préalable est une excellente habitude. Consultez les véritables noms des faits de votre hôte, puis référencez-les avec assurance dans vos tâches.

En lecture seule et sans danger

Le module setup se contente de lire les informations : il ne modifie rien sur l'hôte. Exécutez-le aussi souvent que vous le souhaitez pour enquêter.

Vérification rapide

Comment afficher les faits d'un seul hôte à l'écran ?

Récapitulatif

Vous avez utilisé le module setup pour afficher et filtrer les faits, en découvrant les véritables noms de clés avant de vous y fier dans vos playbooks. ✨

Questions Fréquemment Posées

La leçon « Explorer les faits avec le module setup » est-elle gratuite ?

Oui — le texte complet de « Explorer les faits avec le module setup » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Ansible Academy, passe à CoddyKit PRO. Le cours Ansible Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Explorer les faits avec le module setup » ?

Affichez et parcourez l’arbre des faits d’un hôte. Tu pratiques Ansible Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Ansible Academy ?

Aucune expérience préalable n'est requise. Ansible Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Explorer les faits avec le module setup » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Ansible Academy ?

Oui. Chaque leçon Ansible Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Ce que sont les faits et leur importance
  2. Explorer les faits avec le module setup
  3. Utiliser ansible_facts dans les tâches
  4. Désactiver la collecte des faits pour gagner du temps
← Retour à Ansible Academy