terraci graph

Display and export the dependency graph.

Synopsis

terraci graph [flags]

Description

The graph command visualizes module dependencies in various formats.

Flags

Flag	Short	Type	Default	Description
--format	-f	string	dot	Output format (dot, list, levels)
--output	-o	string	stdout	Output file path
--stats		bool	false	Show graph statistics
--module	-m	string		Query specific module
--dependents		bool	false	Show reverse dependencies

Formats

DOT Format

GraphViz DOT format for visualization:

terraci graph --format dot -o deps.dot

Output:

digraph dependencies {
  rankdir=LR;
  node [shape=box];

  "platform/prod/us-east-1/vpc";
  "platform/prod/us-east-1/eks";
  "platform/prod/us-east-1/rds";

  "platform/prod/us-east-1/eks" -> "platform/prod/us-east-1/vpc";
  "platform/prod/us-east-1/rds" -> "platform/prod/us-east-1/vpc";
}

Render with GraphViz:

terraci graph -f dot -o deps.dot
dot -Tpng deps.dot -o deps.png
dot -Tsvg deps.dot -o deps.svg

List Format

Simple text list:

terraci graph --format list

Output:

Dependencies:
  platform/prod/us-east-1/eks → platform/prod/us-east-1/vpc
  platform/prod/us-east-1/rds → platform/prod/us-east-1/vpc
  platform/prod/us-east-1/app → platform/prod/us-east-1/eks
  platform/prod/us-east-1/app → platform/prod/us-east-1/rds

Levels Format

Execution levels:

terraci graph --format levels

Output:

Execution Levels:
  Level 0: vpc, iam
  Level 1: eks, rds, cache
  Level 2: app-backend, app-frontend
  Level 3: monitoring

Statistics

terraci graph --stats

Output:

Graph Statistics:
  Total modules: 12
  Total edges: 15
  Max depth: 4
  Root modules: 2
  Leaf modules: 3

  Modules with most dependencies:
    app (3 dependencies)
    monitoring (2 dependencies)

  Most depended-on modules:
    vpc (5 dependents)
    eks (2 dependents)

Module Queries

Dependencies of a Module

terraci graph --module platform/prod/us-east-1/app

Output:

Module: platform/prod/us-east-1/app

Dependencies (this module depends on):
  - platform/prod/us-east-1/eks
  - platform/prod/us-east-1/rds

Dependents of a Module

terraci graph --module platform/prod/us-east-1/vpc --dependents

Output:

Module: platform/prod/us-east-1/vpc

Dependents (modules that depend on this):
  - platform/prod/us-east-1/eks
  - platform/prod/us-east-1/rds
  - platform/prod/us-east-1/cache

Examples

Generate PNG Visualization

terraci graph -f dot | dot -Tpng > deps.png

Save to File

terraci graph --format dot --output dependencies.dot

Integration with Other Tools

# Count dependencies
terraci graph --format list | wc -l

# Find modules with many deps
terraci graph --stats | grep "most dependencies" -A 5

# Filter specific service
terraci graph --format list | grep "platform/"

CI Documentation

generate-docs:
  script:
    - terraci graph -f dot -o deps.dot
    - dot -Tsvg deps.dot -o public/dependencies.svg
  artifacts:
    paths:
      - public/dependencies.svg

DOT Customization

The DOT output can be customized with GraphViz:

# Horizontal layout
terraci graph -f dot | sed 's/rankdir=LR/rankdir=TB/' | dot -Tpng > deps.png

# Different node shapes
terraci graph -f dot | sed 's/shape=box/shape=ellipse/' | dot -Tpng > deps.png

# Colored output
dot -Tpng -Gcolor=lightblue deps.dot -o deps.png

Use Cases

Documentation

Generate dependency documentation:

echo "# Dependencies" > DEPENDENCIES.md
echo "" >> DEPENDENCIES.md
echo "![Dependency Graph](deps.svg)" >> DEPENDENCIES.md
terraci graph -f dot | dot -Tsvg > deps.svg

Impact Analysis

See what's affected by changing a module:

terraci graph -m platform/prod/vpc --dependents

Debugging

Find why a module is included:

terraci graph -m platform/prod/app
# Shows what app depends on