Organisation de répertoires recommandée
Découvrez où résident les playbooks, l’inventaire et les variables.
Organisation de répertoires recommandée est une leçon Ansible Academy gratuite sur CoddyKit. Ceci est la leçon 1 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.
Pourquoi l'organisation compte
Lorsque les projets prennent de l'ampleur, des fichiers dispersés deviennent vite chaotiques. Une organisation standard des répertoires indique précisément à votre équipe où se trouve chaque élément. 📁
Le point d'entrée site.yml
Par convention, site.yml est le livre de procédures de niveau supérieur qui relie toute votre infrastructure et inclut les autres éléments.
# site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.ymlL'inventaire à la racine
Votre fichier (ou répertoire) d'inventaire se trouve près du sommet de l'arborescence, afin que les livres de procédures placés à côté sachent toujours quels hôtes ils gèrent.
myproject/
inventory
site.ymlDes livres de procédures par fonction
Divisez les grandes exécutions en fichiers ciblés comme webservers.yml et dbservers.yml, puis assemblez-les depuis site.yml.
Le répertoire group_vars
Un répertoire group_vars contient les variables qui s'appliquent à des groupes d'hôtes entiers ; elles sont chargées automatiquement à partir du nom du groupe.
group_vars/
webservers.yml
dbservers.ymlLe répertoire host_vars
Le répertoire host_vars fait la même chose pour des machines individuelles, avec un fichier portant le nom de chaque hôte.
host_vars/
web01.example.com.ymlLe répertoire roles
L'automatisation réutilisable se trouve dans un répertoire roles. Ansible le consulte en premier lorsqu'une exécution fait référence à un rôle par son nom.
roles/
common/
nginx/Bibliothèque personnalisée et modules d'extension
Un dossier library contient les modules personnalisés, tandis que module_utils ou filter_plugins contiennent du code auxiliaire partagé qu'Ansible découvre automatiquement.
Gardez ansible.cfg à proximité
Placez ansible.cfg à la racine du projet. Ansible récupère la configuration depuis votre répertoire courant, ce qui conserve les paramètres au niveau du projet.
# ansible.cfg
[defaults]
inventory = ./inventory
roles_path = ./rolesUn dépôt, une vue d'ensemble
Avec cette organisation, un seul clonage git fournit à un collègue les livres de procédures, l'inventaire, les variables et les rôles sous une forme cohérente unique. 🎯
La structure complète
Voici la structure recommandée par la documentation officielle. Mémorisez l'organisation, pas chaque fichier.
myproject/
ansible.cfg
inventory
site.yml
group_vars/
host_vars/
roles/Vérification rapide
Quel fichier constitue le point d'entrée conventionnel de niveau supérieur pour un projet complet ?
Récapitulatif
Vous avez appris l'organisation standard : site.yml, l'inventaire, group_vars, host_vars et roles dans un même dépôt. Une structure prévisible évolue avec votre équipe. ✅
Questions Fréquemment Posées
La leçon « Organisation de répertoires recommandée » est-elle gratuite ?
Oui — le texte complet de « Organisation de répertoires recommandée » 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 « Organisation de répertoires recommandée » ?
Découvrez où résident les playbooks, l’inventaire et les variables. 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 1 sur 4.
Combien de temps prend la leçon « Organisation de répertoires recommandée » ?
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
- Organisation de répertoires recommandée
- Répertoires group_vars et host_vars
- Fractionner les playbooks avec import et include
- Nommage, commentaires et style évolutifs