Skip to main content
ubx graph outputs the resource dependency graph for your .iac files as a DOT diagram or ASCII tree.

​
Usage

ubx graph [path] [flags]

​
Examples

ubx graph                    # ASCII tree to terminal
ubx graph --format dot       # DOT format for Graphviz
ubx graph --format dot | dot -Tpng -o graph.png  # render as PNG

​
Flags

FlagDescription
--format stringOutput format: text (default) or dot
--env stringTarget environment

​
ASCII Output

  unit.aws_rds_instance.db
  └── deploy.helm.backend
      └── output.db_endpoint

  unit.aws_s3_bucket_v2.assets
  └── output.bucket_name

​
DOT Output

digraph {
  "aws_rds_instance.db" -> "deploy.helm.backend"
  "deploy.helm.backend" -> "output.db_endpoint"
  "aws_s3_bucket_v2.assets" -> "output.bucket_name"
}

​
Use Cases

  • Understanding dependency chains before ubx plan
  • Debugging why a resource is being updated
  • Documenting infrastructure for onboarding