Anatomie du répertoire d’un rôle

Un rôle est simplement un dossier contenant un ensemble fixe de sous-dossiers. Ansible connaît chaque dossier par son nom et charge automatiquement son contenu.

Le fichier tasks/main.yml contient la liste principale des tâches du rôle. C’est la première chose qu’Ansible exécute lorsque le rôle est appliqué.

Le dossier handlers définit des actions telles que le redémarrage d’un service. Les tâches notifient ces gestionnaires afin que les redémarrages n’aient lieu qu’en cas de modification.

Placez vos fichiers modèles .j2 dans templates/. Le module de modèles les trouve à cet emplacement grâce à leur nom, sans chemin complet.

Le dossier files stocke les fichiers ordinaires que vous copiez tels quels. Le module de copie les localise automatiquement, comme pour les modèles.

Le fichier defaults/main.yml contient les variables ayant la priorité la plus faible. Les utilisateurs peuvent donc facilement les remplacer depuis l’extérieur du rôle.

Le fichier vars/main.yml contient des variables ayant une priorité plus élevée. Utilisez-le pour les valeurs dont dépend le rôle et qui devraient rarement changer.

Le fichier meta/main.yml répertorie l’auteur du rôle, sa licence, les plateformes prises en charge et les éventuelles dépendances du rôle.

Dans les dossiers tasks, handlers, vars et defaults, Ansible charge automatiquement le fichier nommé main.yml. Cette convention de nommage assure la cohérence de l’ensemble.

Un rôle n’a pas besoin de tous les dossiers. S’il ne contient aucun modèle, ignorez simplement le dossier templates. Ansible ignore les dossiers facultatifs absents.

Les rôles aboutis ajoutent un fichier README et un dossier tests afin que les autres personnes puissent comprendre et vérifier votre automatisation avant de l’utiliser.

Un rôle est une arborescence de dossiers où les tâches, les gestionnaires, les modèles, les fichiers, les valeurs par défaut, les variables et les métadonnées ont chacun leur emplacement fixe, le tout organisé autour de main.yml. 📁