ansible-viz

GraphViz depiction of Ansible dependencies.

Run:

gem install bundler
bundle install
bundle exec ruby bin/ansible-viz.rb <path-to-playbook-dir>

Now browse viz.html or with-vars.html. The diagram is drawn client-side with viz.js.

There are probably still a few bugs, particularly around var usage tracking.

See sample/README.txt for details on test data. Run

bundle exec rake test

to execute tests and generate a coverage report. The tests create a graph of the sample data in test.html.

Example

History

This tool was originally written by Alexis Lee, who kindly agreed to transfer maintainership over so that the project could be revived.

Similar projects

• ARA is an awesome tool, but it doesn't generate graphs. It also relies on run-time analysis, which has both pros and cons vs. static analysis.

• ansigenome has lots of cool things rather than specialising on graphing. The current maintainer actually tried it before trying ansible-viz (let alone before accidentally becoming maintainer), but it didn't meet his graphing needs at the time. Still potentially worth looking at though.

• ansible-roles-graph is similar but much simpler and is written in Python.