Back to Terragrunt

Dag Queue Display

docs/src/data/experiments/dag-queue-display.mdx

1.0.31.5 KB
Original Source

Display the run queue as a DAG tree showing dependency hierarchy.

dag-queue-display - What it does

By default, Terragrunt displays the run queue as a flat list of units before execution. When this experiment is enabled, the queue is rendered as a tree that visualizes dependency relationships between units. Independent units appear as siblings at the root, while dependent units are nested under their dependencies.

The tree also changes its header message based on execution direction:

  • Apply/Plan: "starting with dependencies and then their dependents"
  • Destroy: "starting with dependents and then their dependencies"
bash
terragrunt run --all --experiment dag-queue-display -- plan

Example output:

The following units will be run, starting with dependencies and then their dependents:
.
├── monitoring
╰── vpc
    ╰── database
        ╰── backend-app
            ╰── frontend-app

dag-queue-display - How to provide feedback

Provide your feedback on the DAG Queue Display GitHub Discussion.

dag-queue-display - Criteria for stabilization

To transition the dag-queue-display feature to a stable release, the following must be addressed, at a minimum:

  • Community feedback on the tree visualization format
  • Confirm readability with large dependency graphs
  • Confirm compatibility with CI/CD log viewers (color and Unicode handling)