Ansible 027 – LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…)

TL;DR

Cet episode de la formation Ansible traite de **LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…)**. L objectif est de mettre en pratique Roles Ansible avec une approche progressive. Le depot tutorials-ansible fournit le support de cours et, quand il existe, les fichiers pratiques dans 27-roles-pratique.

LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…): c est quoi exactement ?

Les roles structurent les playbooks en conventions de repertoires: tasks, handlers, templates, defaults, vars, files et meta. Ils facilitent la reutilisation, mais demandent de garder des interfaces de variables simples et documentees pour eviter la complexite inutile.

Dans cet article, on relie la video, le support GitLab et une lecture operationnelle du sujet. L objectif n est pas de remplacer la video, mais de fournir une fiche de synthese indexable, reutilisable et reliee aux autres episodes de la playlist.

Le probleme concret que cet episode resout

Le sujet **LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…)** repond a un besoin frequent dans les environnements DevOps: automatiser sans transformer les scripts en suite d actions fragiles. Avec Ansible, on cherche a decrire un etat attendu, a versionner cette description et a pouvoir relancer l execution sans surprise.

Pour un debutant, le risque est souvent de memoriser une commande sans comprendre le modele mental. Pour un profil plus avance, le risque inverse est de complexifier trop vite avec des roles, variables ou templates qui masquent l intention. Cet episode sert donc de point d ancrage dans la progression.

Ce que montre le support Xavki

Le support principal de ce chapitre est disponible ici: 27-roles-pratique.

Points cles extraits du support de cours:

• arborescence de répertoires et fichiers yaml: tasks: les actions et le point d’entrée, defaults: les variables par défaut, vars: les variables de rôle, handlers: les déclencheurs, templates: les fichiers jinja, files: les fichiers à copier ou fichiers statiques, meta: pour partager sur galaxya et inclure les dépendances, test: éléments de test, library: modules spécifiques au rôle
• 3 rôles: ssh_keygen: génération de la clef en local (pb become yes), users: création des users et déploiement des clefs, nginx: installation d’un reverse proxy
• name: mon premier playbook: ssh_keygen
• name: mon premier playbook: name: generate SSH key"
• ROLE USERS: création d’un user et ajout de la clef ssh: name: création du user devops, name: Add devops user to the sudoers, name: Deploy SSH Key
• ROLE NGINX: installation du serveur nginx: name: install nginx, name: remove default file, "/etc/nginx/sites-available/default", "/etc/nginx/sites-enabled/default", name: install vhost, name: Flush handlers
• ROLE NGINX: start: name: start nginx
• handlers: name: reload_nginx
• name: utilisation des rôles: users, nginx
• name: utilisation des rôles

Exemple de code 1 (shell)

ansible-galaxy init roles/user

Exemple de code 2 (shell)

├── 00_inventory.yml
├── group_vars
├── host_vars
├── playbook.yml
└── roles
    └── users
        ├── defaults
        │   └── main.yml
        ├── files
        ├── handlers
        │   └── main.yml
        ├── meta
        │   └── main.yml
        ├── README.md
        ├── tasks
        │   └── main.yml
        ├── templates
        ├── tests
        │   ├── inventory
        │   └── test.yml
        └── vars
            └── main.yml

Exemple de code 3 (shell)

- name: mon premier playbook
  hosts: localhost
  connection: local
  roles:
  - ssh_keygen

Exemple de code 4 (shell)

- name: generate SSH key"
    openssh_keypair:
      path: /tmp/xavki
      type: rsa
      size: 4096
      state: present
      force: no

Fichiers utiles repérés dans le repertoire du chapitre:

• 27-roles-pratique/demo/ansible_dir/00_inventory.yml
• 27-roles-pratique/demo/ansible_dir/playbook.yml
• 27-roles-pratique/demo/ansible_dir/roles/ssh_keygen/.travis.yml
• 27-roles-pratique/demo/ansible_dir/roles/ssh_keygen/README.md
• 27-roles-pratique/demo/ansible_dir/roles/ssh_keygen/tests/test.yml
• 27-roles-pratique/demo/ansible_dir/roles/ssh_keygen/vars/main.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/.travis.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/README.md
• 27-roles-pratique/demo/ansible_dir/roles/users/defaults/main.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/handlers/main.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/meta/main.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/tasks/main.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/tests/test.yml
• 27-roles-pratique/demo/ansible_dir/roles/users/vars/main.yml
• 27-roles-pratique/slides.md

Modele mental minimal

Pour raisonner avec Ansible, gardez cette chaine en tete: **inventaire -> variables -> playbook -> modules -> resultat observe**. Quand une execution ne produit pas l effet attendu, il faut revenir dans cet ordre plutot que corriger au hasard.

Le numero de l episode aide aussi a situer le sujet dans la serie. Les premiers chapitres posent les bases, les chapitres intermediaires explorent les modules et les roles, puis la formation avance vers Docker, AWX, AWS, ELK, Jinja2 et la creation de modules.

Cas d usage concrets

Voici quelques cas d usage typiques pour ce sujet:

Bonnes pratiques associes

• Garder les roles simples et focalises sur une tache
• Documenter les variables requises dans defaults/main.yml
• Utiliser des tags pour permettre des executions selectives
• Tester chaque role independamment

Pieges courants a eviter

• Creer des roles trop complexes et monolithiques
• Ne pas documenter les variables attendues
• Utiliser des dependances circulaires entre roles
• Oublier de tester les roles individuellement

Exemple de pratique conseillee

Une bonne maniere d utiliser cet episode consiste a repartir du repertoire 27-roles-pratique, lire le support, puis reproduire les commandes dans un environnement jetable. Si le chapitre contient des playbooks ou roles, lancez d abord une lecture statique: inventaire utilise, variables attendues, modules appeles, handlers eventuels et fichiers templates.

Ensuite seulement, executez le playbook sur une cible de test. L interet est de comparer trois choses: ce que le playbook declare, ce qu Ansible affiche pendant l execution, et ce qui existe reellement sur la machine apres le run.

Pour aller plus loin

• Creer un role personnalise pour votre infrastructure
• Utiliser ce role dans un playbook complexe
• Partager le role avec la communaute Galaxy
• Documenter le role avec des exemples

Points de vigilance

• Ne stockez pas de secrets en clair dans les variables ou les inventaires.
• Verifiez toujours l idempotence en relancant le playbook au moins une deuxieme fois.
• Preferez un module Ansible dedie a une commande shell quand le module existe.
• Gardez les variables lisibles: trop de niveaux rendent le debug plus difficile.
• Documentez les prerequis locaux: collections, roles Galaxy, version d Ansible et acces SSH.

Liens internes conseilles

• Episode precedent: Ansible 026 – LES ROLES : PRINCIPES ET STRUCTURE
• Episode suivant: Ansible 028 – LE MODULE SYSTEMD : START, DAEMON-RELOAD, ENABLED…
• Parcours conseille: formation Ansible en francais

Liens utiles

• Depot GitLab Xavki tutorials-ansible
• Support du chapitre 27-roles-pratique
• Slides du chapitre
• Playlist YouTube Ansible Xavki
• Video YouTube de l episode
• Documentation Ansible
• Guide Ansible: getting started
• Index des modules et collections Ansible
• Utiliser les roles

FAQ

Cet episode suffit-il pour maitriser LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…) ?

Non. Il sert de point d entree ou de chapitre cible dans une progression plus large. Il faut le completer par la pratique sur le depot et par les episodes voisins de la playlist. La maitrise vient de l experience pratique et de la repetition sur differents cas d usage.

Faut-il regarder la video ou lire uniquement le depot ?

Les deux sources sont complementaires. La video donne le fil pedagogique, le contexte et les explications orales, tandis que le depot donne les chemins, supports et fichiers concrets a reprendre. Pour une comprehension complete, combinez les deux approches.

Comment verifier que j ai compris ce chapitre ?

Relancez l exemple sur un environnement de test, modifiez volontairement une variable ou une cible, puis expliquez le resultat obtenu. Si vous savez diagnostiquer l ecart entre l etat attendu et l etat reel, le chapitre est compris. Essayez aussi d adapter l exemple a un cas similaire mais different.

Peut-on reutiliser directement ces fichiers en production ?

Le depot est un support pedagogique. Avant un usage production, il faut revoir les versions, les secrets, les droits, les inventaires, les handlers, les sauvegardes et les contraintes propres a votre infrastructure. Adaptez toujours les exemples a votre contexte specifique.

Quels sont les prerequis pour suivre cet episode ?

Les prerequis varient selon le numero. Pour les premiers episodes, une connaissance basique de Linux et de SSH suffit. Pour les episodes avances (AWX, AWS, ELK), il est recommande de maitriser les bases d Ansible et d avoir un environnement de test operationnel.

Conclusion

L episode **Ansible 27 – LES ROLES : MISE EN PRATIQUE (EX : USER, NGINX…)** s inscrit dans une formation progressive qui part des fondamentaux pour aller vers des cas DevOps plus complets. L important est de conserver une logique simple: comprendre le sujet, lire les fichiers du depot, pratiquer sur un environnement de test, puis relier ce chapitre aux episodes precedents et suivants. La repetition et l experimentation sont les cles pour acquerir une veritable maitrise d Ansible.