masonbivens/blast-radius

Interactive visualizations of Terraform dependency graphs using d3.js

Blast Radius

Blast Radius is a tool for reasoning about Terraform dependency graphs with interactive visualizations. Use Blast Radius to:

• Learn about Terraform or one of its cloud providers, through example configurations.
• Document your infrastructure
• Reason about relationships between resources, and evaluate changes to them.

• Interact with this diagram (and many others) here.

Quickstart

Install Blast Radius with pip, and Graphviz through your system's package manager.

[...]$ pip3 install blast-radius
[...]$ brew install graphviz

Point Blast Radius at an init-ed Terraform project, and connect with your browser.

[...]$ blast-radius --serve /path/to/terraform-project
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Implementation Details

Blast Radius uses the Graphviz package to layout graph diagrams, PyHCL to parse Terraform configurations, and d3.js to implement interactive features and animations.

Further Reading

• The motivations for Blast Radius are documented in a series of blog posts: part 1, and part 2.
• A catalog of example Terraform configurations, and their dependency graphs can be found at https://28mm.github.io/blast-radius-docs/.