Mirrors/ansible-playbook-grapher
2
0
Fork 0
mirror of https://github.com/haidaraM/ansible-playbook-grapher synced 2024-11-12 23:17:07 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
182 commits 3 branches 52 tags 3.2 MiB
Python 95.7%
JavaScript 2.9%
Makefile 0.6%
Shell 0.4%
CSS 0.2%
Other 0.2%
Find a file
Mohamed El Mouctar Haidara 8b7e92cdc2
Update dependencies (#29) 
* Update lxml to 4.5.0

* Update graphiz to 0.13.2 and ansible min version to 2.8.0

* Update packaging to 20.1

* Pin package versions in test requirements
2020-02-25 16:23:08 +00:00
.github/ISSUE_TEMPLATE Update issue templates 2019-06-06 22:42:28 +02:00
ansibleplaybookgrapher Make sure that an element exists before assigning it (#26) 2020-02-25 16:09:15 +00:00
tests Update dependencies (#29) 2020-02-25 16:23:08 +00:00
.gitignore Ignore vagrant related files 2020-01-13 18:26:54 +01:00
.travis.yml Add ansible 2.9.5 in travis 2020-02-18 13:49:42 +00:00
CHANGELOG.md Update changelog for 0.9.2 2020-02-18 13:41:05 +00:00
LICENSE add license 2017-11-06 13:43:31 +01:00
Makefile move tests related files to tests/, FIXTURES_DIR relative to tests 2019-03-26 00:25:34 +01:00
MANIFEST.in fix bug where the data files are not included in the package 2017-11-08 17:49:18 +01:00
Readme.md Support for Ansible 2.9 (#25) 2020-01-13 20:17:10 +01:00
requirements.txt Update dependencies (#29) 2020-02-25 16:23:08 +00:00
setup.cfg Add ability to run the tests with "python setup.py test" 2019-02-18 22:21:13 +01:00
setup.py Fix requirements_tests path in setup.py 2019-03-26 00:25:34 +01:00
test_install.sh fix: main should not return anything, update tests 2019-02-19 00:28:51 +01:00

Readme.md

Ansible Playbook Grapher

Build Status PyPI version Coverage Status

ansible-playbook-grapher is a command line tool to create a graph representing your Ansible playbook tasks and roles. The aim of this project is to quickly have an overview of your playbook.

Inspired by Ansible Inventory Grapher.

Prerequisites

  • Ansible >= 2.8: The script has not been tested with an earlier version of Ansible, some features may not work. If you still use an older version of Ansible, create an virtual environment and install ansible-playbook-grapher. pip install will install a version of Ansible >= 2.8

  • graphviz: The tool used to generate the graph in SVG.

$ sudo apt-get install graphviz # or yum install or brew install

Installation

$ pip install ansible-playbook-grapher

Usage

$ ansible-playbook-grapher tests/fixtures/example.png

Example

$ ansible-playbook-grapher --include-role-tasks  examples/example_with_roles.yml

Example

Some options are available:

$ ansible-playbook-grapher --help
Usage: ansible-playbook-grapher [options] playbook.yml

Make graph from your Playbook.

Options:
  --ask-vault-pass      ask for vault password
  -e EXTRA_VARS, --extra-vars=EXTRA_VARS
                        set additional variables as key=value or YAML/JSON, if
                        filename prepend with @
  -h, --help            show this help message and exit
  --include-role-tasks  Include the tasks of the role in the graph.
  -i INVENTORY, --inventory=INVENTORY
                        specify inventory host path (default=[%s]) or comma
                        separated host list.
  --new-vault-id=NEW_VAULT_ID
                        the new vault identity to use for rekey
  --new-vault-password-file=NEW_VAULT_PASSWORD_FILES
                        new vault password file for rekey
  -o OUTPUT_FILE_NAME, --ouput-file-name=OUTPUT_FILE_NAME
                        Output filename without the '.svg' extension. Default:
                        <playbook>.svg
  -s, --save-dot-file   Save the dot file used to generate the graph.
  --skip-tags=SKIP_TAGS
                        only run plays and tasks whose tags do not match these
                        values
  -t TAGS, --tags=TAGS  only run plays and tasks tagged with these values
  --vault-id=VAULT_IDS  the vault identity to use
  --vault-password-file=VAULT_PASSWORD_FILES
                        vault password file
  -v, --verbose         verbose mode (-vvv for more, -vvvv to enable
                        connection debugging)
  --version             show program's version number and exit

Contribution

Contributions are welcome. Feel free to contribute by creating an issue or submitting a PR 😃

Dev environment

To setup a new development environment:

  • Install graphviz sudo apt-get install graphviz # or yum install or brew install graphviz
  • pip install -r requirements.txt

Run the tests with:

$ make test

TODO

  • Graphviz : properly rank the edge of the graph to represent the order of the execution of the tasks and roles
  • Graphviz : find a way to avoid or reduce edges overlapping
  • Refactor the graph representation