Ansible 107 – JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES

TL;DR

Cet episode de la formation Ansible traite de **JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES**. L objectif est de rendre les templates dynamiques sans rendre les playbooks illisibles. Le depot tutorials-ansible fournit le support de cours et, quand il existe, les fichiers pratiques dans 107-jinja-filtres.

JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES: c est quoi exactement ?

Jinja2 est le moteur qui transforme des variables Ansible en fichiers de configuration, pages HTML ou payloads structures. Il faut l utiliser comme un outil de templating, pas comme un second langage applicatif cache dans les playbooks. La clarté et la simplicité des templates sont essentielles pour la maintenabilité.

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 **JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES** 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: 107-jinja-filtres.

Points cles extraits du support de cours:

• opérateur de comparaison: name: test
• ternaire: name: test
• default: name: test
• difference (attention sens référence à gauche)

Exemple de code 1 (shell)

- name: test
    copy:
      content: |
        {{ (var1 < var2) }}
      dest: /tmp/xavki.txt

Exemple de code 2 (shell)

vars:
    var1: 10
    var2: 20
    configuration1: |
      ceci est ma conf 1
    configuration2: |
      ceci est ma conf 2
  tasks:
  - name: test
    copy:
      content: |
        {{ (var1 > var2) | ternary(configuration1, configuration2) }}
      dest: /tmp/xavki.txt

Exemple de code 3 (shell)

- name: test
    copy:
      content: |
        {{ var1 | default("xavki") }}
      dest: /tmp/xavki.txt

Exemple de code 4 (shell)

{{ ['a','b','c'] | random }}
    {{ 60 | random }} * * * * root /script/from/cron

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

• 107-jinja-filtres/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:

• Generer des fichiers de configuration dynamiques
• Creer des templates HTML pour des rapports
• Manipuler des structures JSON/YAML dans les playbooks
• Utiliser des filtres pour transformer des donnees

Bonnes pratiques associes

• Garder les templates simples et lisibles
• Eviter la logique complexe dans les templates
• Utiliser des tests et des filtres pour valider les donnees
• Documenter les variables utilisees dans les templates

Pieges courants a eviter

• Mettre trop de logique dans les templates
• Ne pas echapper les variables utilisateur
• Utiliser des boucles complexes dans les templates
• Oublier de tester les templates avec differentes valeurs

Exemple de pratique conseillee

Une bonne maniere d utiliser cet episode consiste a repartir du repertoire 107-jinja-filtres, 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 des templates pour vos fichiers de configuration
• Utiliser Jinja2 avec des structures de donnees complexes
• Tester les templates avec differentes valeurs
• Documenter les variables utilisees dans les templates

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 106 – JINJA : LES CONDITIONS
• Episode suivant: Ansible 108 – JINJA : FILTRES ET MANIPULATIONS MOINS COURANTES
• Parcours conseille: formation Ansible en francais

Liens utiles

• Depot GitLab Xavki tutorials-ansible
• Support du chapitre 107-jinja-filtres
• Slides du chapitre
• Playlist YouTube Ansible Xavki
• Video YouTube de l episode
• Documentation Ansible
• Guide Ansible: getting started
• Index des modules et collections Ansible
• Documentation Jinja
• Templates Ansible

FAQ

Cet episode suffit-il pour maitriser JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES ?

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 107 – JINJA2 : LES FILTRES SUR LES STRINGS ET LES LISTES** 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.