datadrivers/Run Terraform via Terragrunt
This action runs terraform or terragrunt including install, setup and caches
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 8, 2026
- License
- None
Pinned Snippet
uses: datadrivers/terragrunt-action@aa701e2420811b84e587c5c11472ffc41907f81e # v4.4.2tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| terraform-version | terraform version to setup. Use 'disabled' to skip. Leave empty string to let tenv auto-detect (from .terraform-version / .tool-versions). | no | "" |
| tenv-version | tenv version to setup. | no | latest |
| terragrunt-version | terragrunt version to setup. Use 'disabled' to skip. Leave empty string to let tenv auto-detect (from .terragrunt-version / .tool-versions). | no | disabled |
| working-directory | working-directory for github step to run terragrunt/terraform command | no | . |
| terragrunt-cache-extra-key | string appended to terragrunt cache key | no | "" |
| commands | commands execution line. For multiple commands use | multi line syntax; required to generate plan within commands files for pr comments | no | — |
| use-aws-auth | Toggle to log in to aws | no | false |
| aws-region | AWS Region for Login | no | eu-central-1 |
| aws-role-to-assume | AWS IAM Role for github action to access aws api | no | "" |
| aws-role-duration-seconds | AWS session time | no | 1800 |
| use-gcloud-auth | Toggle to log in via gcloud to aws | no | false |
| gcp-workload-identity-provider | The full identifier of the Workload Identity Provider, including the project number, pool name, and provider name. If provided, this must be the full identifier which includes all parts, for example: "projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider". This is required if "use-gcloud-auth" is true. | no | "" |
| gcp-service-account-email | Email address or unique identifier of the Google Cloud service account for which to generate credentials. This is required if "workload_identity_provider" is specified and "use-gcloud-auth" is true. | no | "" |
| gcp-project-id | ID of the default project to use for future API calls and invocations. This is required if "use-gcloud-auth" is true. | no | — |
| terragrunt-download | path to terragrunt cache dir storage | no | $HOME/.terragrunt-cache/ |
| skip-caches | Toggle to skip caches | no | false |
| cache-terraform-plugins | Toggle to cache Terraform provider plugins independently from other caches | no | true |
| cache-terragrunt-caches | Toggle to cache Terragrunt download/cache directory independently from other caches | no | true |
| enable-debug | Add debug output to steps | no | false |
| cache-tenv-tools | Enable caching of tenv managed tool versions (~/.tenv). Speeds up repeated runs by avoiding re-download of identical Terraform/Terragrunt versions. | no | true |
Outputs
| name | description |
|---|---|
| terragrunt-download-dir | Path to the terragrunt cache directory |
| terraform-plugin-cache-dir | Path to the terraform plugin cache directory |
| terragrunt-provider-cache-dir | Path to the terragrunt provider cache directory (used with --provider-cache) |