Rôles Ansible : structure, TDD avec Molecule, tests testinfra et publication

Un rôle transforme un playbook personnel en brique réutilisable par toute une équipe. C'est un répertoire dont Ansible connaît la structure et qu'il charge sans que vous ayez à le déclarer. Cette section couvre son écriture, son test et sa distribution : comment le structurer, comment prouver qu'il fonctionne avant de le partager, et comment le publier sans casser ceux qui en dépendent.

Prérequis

Il faut savoir écrire les tâches qu'un rôle va contenir. La section Écrire du code donne ce bagage : variables, boucles, conditions et gabarits Jinja2. Un rôle n'est qu'un emballage, il n'apprend pas à écrire ce qu'on y range.

Ce que vous allez apprendre

Reconnaître ce qu'Ansible lit vraiment dans un rôle, ce qu'il ignore, et ce que la commande officielle génère.
Écrire un rôle paramétrable dont l'interface publique est claire, et déclarer un contrat d'entrée qui refuse les appels incorrects.
Tester avec Molecule, du premier scénario au cycle complet, y compris sur plusieurs distributions.
Brancher une intégration continue qui teste réellement, au lieu de passer au vert sans rien vérifier.
Consommer un rôle tiers en sachant l'auditer avant de lui confier les droits de votre automatisation.
Publier une version en comprenant ce qui fait foi côté serveur, et ce qui ne protège personne.

Écrire un rôle

Le bloc de base. Il va de l'arborescence à un rôle complet, joué sur une machine réelle et paramétrable par celui qui l'appelle.

Découvrir les rôles Ce qu'un rôle apporte face à un playbook, et quand il devient nécessaire

Structure standard Ce que role init génère, ce qu'Ansible reconnaît sans le générer, ce qu'il ne lit jamais

Créer son premier rôle Du squelette au rôle joué sur une machine, avec la preuve d'idempotence

Variables : defaults et vars Deux répertoires, deux rangs de précédence opposés : l'interface publique et l'interne

Handlers et meta Déclencher un redémarrage depuis un rôle, et déclarer ce dont il dépend

Contrat d'entrée avec argument_specs Valider les paramètres reçus et produire un message d'erreur exploitable

Tester avant de partager

Un rôle qu'une équipe consomme doit prouver qu'il fonctionne, et surtout qu'il échoue pour les bonnes raisons. Ce bloc monte progressivement, du premier scénario Molecule à la matrice multi-versions et à l'intégration continue.

Introduction au TDD avec Molecule Le principe, les étapes de la séquence de test, et ce que chacune vérifie

Installer et configurer Molecule Les fichiers déposés par la commande d'initialisation et le rôle de chacun

Le cycle TDD complet Écrire le test qui échoue, le faire passer, recommencer

Scénarios multi-distributions Vérifier que le rôle tient sur plusieurs systèmes, et ce que cela coûte en temps

Tests avec testinfra Écrire les vérifications en Python, et ce que cela apporte face à un verify.yml

Matrice de versions avec tox Valider un rôle sur plusieurs branches d'ansible-core, et le coût réel de la matrice

ansible-lint en profil production Le profil le plus strict, ce qu'il exige vraiment, et le piège du répertoire courant

Intégration continue GitHub Actions Un pipeline qui teste pour de bon, et la commande qui passe au vert sans rien analyser

Intégration continue GitLab Ce qu'un job doit fournir à Molecule, le coût du cache et la validation du fichier

Consommer et distribuer

Écrire un rôle est une chose, l'utiliser et le diffuser en est une autre. Ce bloc traite les deux sens : intégrer un rôle tiers dans votre projet, et publier le vôtre pour d'autres.

Consommer un rôle Les formes d'appel, leurs différences de comportement, et celle qui saute la validation

Dépendances entre rôles Déclarer qu'un rôle en appelle un autre, et les pièges de la réexécution

La commande ansible-galaxy Deux familles d'objets, deux jeux d'options : savoir laquelle s'applique

Installer des rôles depuis Galaxy Le fichier requirements, les sources acceptées, et l'installation silencieusement sautée

Auditer un rôle existant Ce qu'il faut lire avant d'exécuter du code tiers avec les droits de votre automatisation

Versionner et publier Un rôle n'a pas de fichier de version : le tag Git fait foi, et rien ne l'immobilise

Vérifier vos acquis

Cette section n'a pas encore sa page de quiz dédiée, mais ses 80 questions existent déjà dans la banque commune, aux côtés de celles des autres sections.

Quiz Ansible La banque complète, filtrable par chapitre, dont 80 questions sur les rôles

Pour aller plus loin

Structure standard d'un rôle : les dix dossiers conventionnels et ce qui se range dans chacun.
Créer son premier rôle : le lab qui transforme un playbook en rôle, de l'initialisation au premier run.
Introduction au TDD avec Molecule : pourquoi écrire le test avant le rôle, et ce que cela évite comme régressions.