⚒️ Breaking Changes
The --queue-strict-include flag is deprecated
Terragrunt no longer automatically includes dependencies of included units. As such the --queue-strict-include flag is no longer useful in the Terragrunt CLI.
The flag has been deprecated, and no longer does anything. This flag will not be removed before 2.0.
Run report no longer reports --queue-exclude-dir as a reason for exclusion
Run reports no longer report on units excluded from runs as a consequence of the --queue-exclude-dir flag.
The --units-that-include flag is deprecated
The --units-that-include flag is now an alias for the reading= attribute filter, just like the --queue-include-units-reading flag.
Given that the two flags no longer differ in functionality, and that the functionality of the --units-that-include is no longer strictly including units that are included, the flag has been deprecated.
The double-star strict control is complete
The globbing behavior of Terragrunt in CLI flags has been updated to match all paths when ending with a trailing ** .
🧪 Experiments Completed
The filter-flag experiment is completed
The filter-flag experiment is completed, and the --filter flag is now generally available.
You can use filter expressions as a single unified API for controlling the Run Queue, replacing the need to use the following CLI flags:
| Legacy —queue flag | Equivalent —filter expression |
|---|---|
—-queue-include-dir=path
| —-filter='{./path}'
|
—-queue-exclude-dir=path
| —-filter='!{./path}'
|
--queue-include-units-reading=root.hcl
| --filter='reading=root.hcl'
|
--units-that-include=root.hcl
| --filter='reading=root.hcl'
|
--queue-include-external-dependencies
| --filter='{./**}...'
|
--queue-excludes-file=excludes.txt
| --filters-file='filters.txt' *
|
--graph
| --filter='...{.}'
|
- Note that the file used for the
--queue-excludes-filedoes not directly translate to the kind of file you can use for a--filters-file. To learn more, see the documentation.
The table above also explains the aliasing that has been done internally to replace queue flags with their filter equivalents. The aliasing for these queue flags is present purely for backwards compatibility purposes, but they are not going to emit deprecation warnings, and will not be removed before the Terragrunt 1.0 release.
You are heavily encouraged to adopt the new --filter flag for your infrastructure targeting needs as soon as feasible in your workflows. It will offer a significantly more flexible and powerful experience.
To learn more see the Filters feature documentation.
What's Changed
- fix: Using
testing/synctestto makeTestWriteUnitLevelSummarymore reliable by @yhakbar in #5253 - chore: Cleaning up test symlinks resolution by @yhakbar in #5251
- fix: Fixing report run duplication error by @yhakbar in #5252
- fix: improved log error messages by @denis256 in #5256
- chore: Dropping
ListContainsandListEqualsand using standard library instead by @yhakbar in #5221 - chore: Adding debug log for assume already applied by @yhakbar in #5198
- Adding ambassador by @karlcarstensen in #5261
- Adding ambassador by @karlcarstensen in #5259
- Adding announcement banner by @karlcarstensen in #5260
- chore: Removing latest Terraform OSS workflows by @yhakbar in #5262
- chore: Backporting queue flags into filter flags by @yhakbar in #5241
- docs: Documenting backport of queue flags into filter flags by @yhakbar in #5263
Full Changelog: v0.96.1...v0.97.0-rc2025121901