Ansible - Créer des graphes représentant taches et roles à partir des playbooks
Publié le : 7 avril 2022 | Mis à jour le : 27 juin 2023Voilà 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 :