boogy/terragrunt-runner
Execute Terragrunt in multiple folders and post formatted results to GitHub PRs
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Oct 9, 2025
- License
- MIT
Pinned Snippet
uses: boogy/terragrunt-runner@4ba5fbfce4a6c7de7d6f3660ed9bcba700e57a1e # v1.0.8tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| github-token | GitHub token for API access | no | ${{ github.token }} |
| folders | Comma, space, or newline separated list of folders to run Terragrunt in | no | "" |
| command | Terragrunt command to execute (e.g., 'plan', 'run --all plan', 'run --all -- plan -no-color -var=foo') | no | plan |
| args | Additional Terragrunt arguments | no | --non-interactive --tf-forward-stdout |
| root-dir | Root directory from which to run `terragrunt run --all ...` commands (only used if command includes `run --all`) | no | live |
| parallel | Execute terragrunt in parallel in each folder using goroutines | no | true |
| max-parallel | Maximum parallel executions (0 = unlimited) | no | 5 |
| delete-old-comments | Delete previous bot comments before posting new ones | no | true |
| auto-detect | Auto-detect Terragrunt folders from changed files by walking up directories. Recommended when providing 'changed-files' for efficiency in large repos. | no | false |
| file-patterns | File patterns to track for auto-detection (comma-separated) | no | *.hcl,*.json,*.yaml,*.yml |
| terragrunt-file | Name of the Terragrunt file to look for when walking up directories | no | terragrunt.hcl |
| changed-files | List of changed files for auto-detection (comma-separated) | no | "" |
| max-walk-up | Maximum directory levels to walk up when searching for Terragrunt file | no | 3 |
| max-runs | Maximum number of Terragrunt executions allowed (0 = unlimited) | no | 20 |
| terragrunt-version | Terragrunt version to install (e.g., 'v0.88.1'; must match a release tag with 'v' prefix; leave empty to use pre-installed version) | no | "" |
| opentofu-version | OpenTofu version to install (e.g., '1.8.3'; leave empty to skip installation) | no | "" |
| terraform-version | Terraform version to install (e.g., '1.9.7'; only used if opentofu-version is empty) | no | "" |
| working-directory | Working directory for the action | no | . |
Outputs
| name | description |
|---|---|
| success | Whether all Terragrunt executions succeeded |
| total-resources-to-add | Total number of resources to be added |
| total-resources-to-change | Total number of resources to be changed |
| total-resources-to-destroy | Total number of resources to be destroyed |
| total-resources-to-replace | Total number of resources to be replaced |