Ansible 073 – TP VALO : MISE EN HTML, JINJA…

TL;DR

Cet episode de la formation Ansible traite de **TP VALO : MISE EN HTML, JINJA…**. L objectif est de passer de la notion a un cas pratique reproductible. Le depot tutorials-ansible fournit le support de cours et, quand il existe, les fichiers pratiques dans 73-valorisation-nginx-tp-valorisation.

TP VALO : MISE EN HTML, JINJA…: 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 **TP VALO : MISE EN HTML, JINJA…** 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: 73-valorisation-nginx-tp-valorisation.

Points cles extraits du support de cours:

• installation de nginx et start: name: install nginx
• installation de nginx et start: name: start nginx
• installation de nginx et start: name: clean
• installation de la page d’accueil: name: pages machine, { src: "index.html.j2", dest: "index.html" }, { src: "style.css.j2", dest: "style.css" }
• installation des pages par serveur: name: pages machine
• installation des pages par serveur

Exemple de code 1 (shell)

- name: install nginx
    apt:
      name: nginx

  - name: start nginx
    systemd:
      name: nginx
      state: started
      enabled: yes

  - name: clean
    shell: rm -rf /var/www/html/*

Exemple de code 2 (shell)

- name: pages machine
    template:
      src: "{{ item.src }}"
      dest: "/var/www/html/{{ item.dest }}"
    delegate_to: 172.17.0.2
    with_items:
    - { src: "index.html.j2", dest: "index.html" }
    - { src: "style.css.j2", dest: "style.css" }

Exemple de code 3 (shell)

- name: pages machine
    template:
      src: servers.html.j2
      dest: /var/www/html/server-{{ ansible_hostname }}.html
    delegate_to: 172.17.0.2

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

• 73-valorisation-nginx-tp-valorisation/ansible_dir/00_inventory.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/collect.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/playbook.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/.travis.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/README.md
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/tasks/main.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/templates/index.html.j2
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/templates/servers.html.j2
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/templates/style.css.j2
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/tests/test.yml
• 73-valorisation-nginx-tp-valorisation/ansible_dir/roles/valo_web/vars/main.yml
• 73-valorisation-nginx-tp-valorisation/index.html.j2
• 73-valorisation-nginx-tp-valorisation/servers.html.j2
• 73-valorisation-nginx-tp-valorisation/slides.md
• 73-valorisation-nginx-tp-valorisation/style.css.j2

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 73-valorisation-nginx-tp-valorisation, 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 072 – TP VALO : COLLECTE DE DATAS ET FACTS
• Episode suivant: Ansible 074 – TP VALO : MODULE MAIL, ENVOYONS NOTRE SYNTHESE HTML
• Parcours conseille: formation Ansible en francais

Liens utiles

• Depot GitLab Xavki tutorials-ansible
• Support du chapitre 73-valorisation-nginx-tp-valorisation
• 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 TP VALO : MISE EN HTML, JINJA… ?

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 73 – TP VALO : MISE EN HTML, JINJA…** 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.