Graphes de playbooks 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.

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 :

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 :

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

ansible-playbook-grapher --include-role-tasks /path/to/playbook-with-roles.yml

Un exemple :

Source ↗