Aller au contenu
medium

Graphes de playbooks Ansible

4 min de lecture

logo ansible

Voilà un outil qui va agrémenter la documentation de vos playbooks Ansible. ansible-playbook-grapher est une CLI permettant de créer un graphique représentant la suite des tâches et rôles qui se trouvent dans vos Playbooks Ansible. À intégrer dans vos CI des projets stockant vos playbooks Ansible !

Installer ansible-playbook-grapher

ansible-playbook-grapher est écrit bien sûr en Python et demande la présence de graphviz et d’Ansible bien sûr.

Fenêtre de terminal
sudo apt install graphviz
pip install ansible-playbook-grapher --user

Créer vos graphes de playbooks

Il suffit de lancer la commande suivante en remplaçant le chemin du playbook par le vôtre :

Fenêtre de terminal
ansible-playbook-grapher ~/my-vagrant-box/provision.yml
[WARNING]: No inventory was parsed, only implicit localhost is available
Parsing Play: localhost (1) *******************************************
[WARNING]: Looping on tasks or roles are not supported for the moment.
Only the task having the loop argument will be added to the graph.
Done parsing Play: localhost (1) **************************************
Rendering the graph...
The graph has been exported to provision.svg

Ce qui produit le graph suivant dans le dossier où vous avez lancé la commande :

ansible grapher

Si vos playbooks intègrent des rôles vous pouvez demander à décrire toutes les taches de ceux-ci :

Fenêtre de terminal
ansible-playbook-grapher --include-role-tasks /path/to/playbook-with-roles.yml

Un exemple :

ansible grapher

Source

Ce site vous est utile ?

Sachez que moins de 1% des lecteurs soutiennent ce site.

Je maintiens +700 guides gratuits, sans pub ni tracing. Aujourd'hui, ce site ne couvre même pas mes frais d'hébergement, d'électricité, de matériel, de logiciels, mais surtout de cafés.

Un soutien régulier, même symbolique, m'aide à garder ces ressources gratuites et à continuer de produire des guides de qualité. Merci pour votre appui.