DABs direct deployment engine plan-file tool
Hello,
I originally built this for my team's local DevEx and CI/CD stacks, but figured others might get some use out of it too. With the direct deployment engine for Declarative Automation Bundles heading towards GA, i think it is a good time to share it.
dagshund, a visualizer for DAB plan files.
Zero runtime dependencies. Pipe in a plan.json like this:
databricks bundle plan -o json | uvx dagshund
and depending on what you want you may get:
- a colored diff on stdout for quick sanity checks
- a markdown summary you can drop into a PR comment
- a self-contained interactive HTML report with a resource graph and per-job task DAGs (React Flow + ELK layout, no external assets, just open the file). Live examples here.
The CI piece came out of always feeling a bit blind when deploying large bundles without a terraform-style plan. It also exposes detailed exit codes so you can gate pipelines on drift or dangerous actions (resource replaces & destroys).
The HTML report is for anyone who'd rather see a graph than scroll through a wall of diff text, or who wants more detail on job DAGs than a terminal can fit. It also surfaces lateral dependencies and hierarchy relationships that the plan file mentions but state doesn't track directly, so it's generally just more detailed. We also use them as built artifacts in our PRs.
Docs and full feature list on GitLab, or on the GitHub mirror.
Fair disclaimer: since the direct deployment engine isn't GA yet, expect dagshund to follow along if the plan format shifts before release, sometimes this may take a day or two.
Cheers!