Découvrir un rôle téléchargé : templates, vars, README
Vidéo suivanteCette vidéo est réservée aux abonnés. Voir les abonnements
Objectif
Comprendre comment est construit un rôle téléchargé afin de l'utiliser correctement dans ses playbooks.
Points clés
- Un rôle Galaxy regroupe ses tâches, ses handlers, ses templates Jinja2 (par exemple la configuration de Nginx ou de MySQL et les vhosts) et souvent un dossier
molecule/de tests. - Les paramètres des fichiers de configuration sont variabilisés : leurs valeurs par défaut se trouvent dans
defaults/main.yml. - Des fichiers de variables par famille et version d'OS, chargés selon les facts, rendent le rôle multi-plateforme : le rôle MySQL installe ainsi MySQL sur Debian et MariaDB sur les systèmes Red Hat.
- Le
README.mddocumente les variables disponibles, les prérequis, les dépendances, des conseils de dépannage, la licence et l'auteur. - Plutôt que de modifier les tâches du rôle, on surcharge ses variables dans l'inventaire ou dans le playbook.
À retenir
Lisez toujours le README d'un rôle avant de l'utiliser : il suffit ensuite d'adapter ses variables à votre infrastructure.