{"full_name":"gruntwork-io/terragrunt","owner":"gruntwork-io","name":"terragrunt","shard":"1","url":"https://github.com/gruntwork-io/terragrunt","description":"Terragrunt is a flexible orchestration tool that allows Infrastructure as Code written in OpenTofu/Terraform to scale.","homepage":"https://terragrunt.com","topics":["terraform","devops","cli","aws","developer-tools","opentofu"],"tag_pages":["aws","cli","developer-tools","devops","opentofu","terraform"],"language":"Go","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/17118990?v=4","created_at":"2016-05-23T22:17:48Z","pushed_at":"2026-11-15T14:39:27Z","metrics":{"stars":9924,"forks":1250,"watchers":119,"issues":3135,"prs":4027,"releases":955,"issues_open":117,"issues_closed":3018,"prs_open":117,"prs_closed":694,"prs_merged":3216,"discussions":151},"growth":{"day":{"stars":2,"forks":-1,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[9917,9919,9921,9921,9922,9922,9924],"forks":[1249,1249,1250,1250,1251,1251,1250],"watchers":[null,119,119,119,119,119,119],"issues_open":[null,125,118,118,117,117,117],"prs_open":[null,89,92,104,108,110,117]},"boards":{},"same_owner":[],"issues":[{"number":3363,"title":"Standalone provider cache server","comments":34,"created_at":"2024-08-26T11:37:16Z"},{"number":4402,"title":"Replace `inputs` attribute with `variables` block","comments":21,"created_at":"2025-06-09T14:07:15Z"},{"number":2779,"title":"Language Server for Terragrunt","comments":19,"created_at":"2023-11-05T22:06:13Z"},{"number":6002,"title":"run --all plan: state lock contention on shared dependencies (race introduced v0.97.0, fatal in v0.99.0)","comments":18,"created_at":"2026-04-30T02:44:32Z"},{"number":3234,"title":"Too many requests (429) on local cache server with high parallelism","comments":16,"created_at":"2024-07-02T14:37:27Z"},{"number":250,"title":"Clean command : Remove S3 bucket and DynamoDB table","comments":16,"created_at":"2017-07-05T08:42:16Z"},{"number":4314,"title":"Stacks: Approach to lock file handling","comments":15,"created_at":"2025-05-21T08:30:17Z"},{"number":1448,"title":"run_cmd is always executed - ternary operator is not correctly supported","comments":15,"created_at":"2020-11-29T13:49:02Z"}],"discussions":[{"number":7356,"title":"resource contention on macOS","comments":1,"category":"General","created_at":"2026-11-13T18:32:18Z"},{"number":7322,"title":"Experiment: outputs-block","comments":0,"category":"Experiment Feedback","created_at":"2026-11-12T14:14:43Z"},{"number":7308,"title":"Experiment: variables-block","comments":0,"category":"Experiment Feedback","created_at":"2026-11-11T16:42:40Z"},{"number":7307,"title":"Experiment: no-dot-terragrunt-cache","comments":1,"category":"Experiment Feedback","created_at":"2026-11-11T16:42:20Z"},{"number":7208,"title":"Why doesn't `--source-map` support prefix matching?","comments":0,"category":"General","created_at":"2026-10-27T19:30:52Z"},{"number":7145,"title":"Relative `source` on a block injected by a stack-level `autoinclude` fails `stack generate` (\"relative paths require a module with a pwd\")","comments":2,"category":"General","created_at":"2026-10-15T20:02:31Z"},{"number":7139,"title":"v1.2.0-rc3","comments":0,"category":"Pre-release Feedback","created_at":"2026-10-15T17:13:26Z"},{"number":7118,"title":"Experiment: tg-login","comments":0,"category":"Experiment Feedback","created_at":"2026-10-13T20:55:26Z"}],"latest_release":{"name":"v1.2.2","tag":"v1.2.2","published_at":"2026-11-11T15:21:00Z","body":"## 🏎️ Performance Improvements\r\n\r\n## Faster dependency discovery in large repositories\r\n\r\n`run --all`, and `find` or `list` with `--dependencies`, are faster in large repositories, including ones with no `dependency` blocks. The time spent linking units to their dependencies now grows linearly with the number of units instead of quadratically.\r\n\r\nIn [benchmarks](https://github.com/gruntwork-io/terragrunt/blob/main/internal/discovery/benchmark_relationship_test.go) on an AMD Ryzen AI Max+ 395, discovering units and their dependencies in a generated repository of 10-unit dependency chains:\r\n\r\n| units | before | after |\r\n| --- | --- | --- |\r\n| 10 | 0.63ms | 0.63ms |\r\n| 100 | 5.2ms | 5.0ms |\r\n| 1,000 | 56ms | 47ms |\r\n| 10,000 | 1.32s | 443ms |\r\n\r\nAt 10,000 units, memory allocated during discovery dropped from 8.6 GB to 1.9 GB.\r\n\r\n## Faster discovery with dependent filters\r\n\r\nTerragrunt wastes less time resolving symlinks in discovery. Dependent filters, such as `--filter '...vpc'` were able to reduce the number of wasted syscalls to resolve symlinks, improving dependent discovery.\r\n\r\nOn a repository of 1,024 units, discovery with a dependent filter took 30% less time from the repository root and 47% less time from the target unit's directory on an M3 Max. It also allocated 12-16% less memory.\r\n\r\n## Faster discovery of dependencies\r\n\r\nDiscovery prepared to read a `terragrunt.stack.hcl` in every directory named by a `dependency` or `dependencies` block, even when the directory was a unit. It now does that work only when the stack file exists.\r\n\r\nIn [benchmarks](https://github.com/gruntwork-io/terragrunt/blob/main/internal/discovery/benchmark_dependents_test.go) on an AMD Ryzen AI Max+ 395, selecting the dependents of a unit that every other unit depends on, run from that unit's directory:\r\n\r\n| units | before | after |\r\n| --- | --- | --- |\r\n| 10 | 2.9ms | 2.3ms |\r\n| 100 | 118ms | 86ms |\r\n| 1,000 | 11.1s | 8.0s |\r\n\r\nAt 1,000 units, memory allocated during discovery dropped from 26.7 GiB to 10.3 GiB.\r\n\r\n## 💡 Tips Added\r\n\r\n## `inputs-read-not-tracked` — Points at files read in `inputs` that reading filters miss\r\n\r\nTerragrunt does not track a file read in `inputs`. A unit with this configuration is not selected by `--filter 'reading=config.yml'` or by a Git filter when `config.yml` changes:\r\n\r\n```hcl\r\n# terragrunt.hcl\r\n\r\ninputs = {\r\n  message = yamldecode(file(\"config.yml\")).message\r\n}\r\n```\r\n\r\nThe same applies to `inputs` in an `autoinclude` block of a stack file.\r\n\r\nCommands that track reads, such as `run --all` with a reading or Git filter and `find --reading`, now print the `inputs-read-not-tracked` tip pointing at each such read:\r\n\r\n```text\r\nTIP (inputs-read-not-tracked): Terragrunt does not track files read in `inputs`, so reading and Git filters miss the units and stacks that read them.\r\n\r\nUntracked file read in `inputs`\r\n --> app/terragrunt.hcl:4:24\r\n  |\r\n4 |   message = yamldecode(file(\"config.yml\")).message\r\n  |                        ^^^^^^^^^^^^^^^^^^ Read the file in `locals` and reference the local here.\r\n\r\nUntracked file read in an `autoinclude` block's `inputs`\r\n --> live/terragrunt.stack.hcl:16:29\r\n   |\r\n16 |       policy = templatefile(\"policy.json.tftpl\", { role_arn = dependency.iam.outputs.role_arn })\r\n   |                             ^^^^^^^^^^^^^^^^^^^\r\n   |\r\n   = Mark the template as read with `mark_as_read` in the stack's `locals`, then pass the local as the path here.\r\n\r\nSee https://docs.terragrunt.com/features/filter/attributes#reading-based-expressions\r\n```\r\n\r\nSee [Reading-Based Expressions](https://docs.terragrunt.com/features/filter/attributes#reading-based-expressions). Suppress the tip with `--no-tip inputs-read-not-tracked` or `--no-tips`.\r\n\r\n## 🔒 Strict Controls Added\r\n\r\n## `cas-source-inside-stack` strict control\r\n\r\nA `unit` or `stack` block with `update_source_with_cas` could set a source inside the directory of its own stack file, e.g. a catalog with its stack at the root and its units under `units/`:\r\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}