terragrunt 0.97.0

[BrewTestBot]

Created by brew bump

---

Created with brew bump-formula-pr.

Details

release notes

## ⚒️ 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-file does 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.
🐛 Bug Fixes
The get_original_terragrunt_dir() function is now supported in terragrunt.stack.hcl files
When authoring explicit stacks, using the get_original_terragrunt_dir() HCL function in terragrunt.stack.hcl files will now return the directory where the terragrunt.stack.hcl file lives, even when the configuration is read from another stack/unit using read_terragrunt_config().
Using Git-based expressions with the --out-dir flag is fixed
When using Git-based expressions using the --filter flag, the relative path of units relative to their respective Git worktree roots is used for determining where the plan file will be saved, rather than a path in the relevant Git worktree.
Color for output fetching is suppressed more reliably
Terragrunt will use tofu output -json / terraform output -json more reliably when users expect a lack of colors (like when colors are suppressed for Terragrunt).
What's Changed

fix: Using testing/synctest to make TestWriteUnitLevelSummary more reliable by @yhakbar in fix: Using testing/synctest to make TestWriteUnitLevelSummary more reliable gruntwork-io/terragrunt#5253
fix: Fixing report run duplication error by @yhakbar in fix: Fixing report run duplication error gruntwork-io/terragrunt#5252
fix: improved log error messages by @denis256 in fix: improved log error messages gruntwork-io/terragrunt#5256
fix: get_original_terragrunt_dir during stack generate by @philipmckenna-symphony in fix: get_original_terragrunt_dir during stack generate gruntwork-io/terragrunt#5176
fix: saving of plan in git based filtering by @denis256 in fix: saving of plan in git based filtering gruntwork-io/terragrunt#5288
fix: add no color for dependency fetching by @denis256 in chore: add no color for dependency fetching gruntwork-io/terragrunt#5285
fix: added git worktree cleanup on errors by @denis256 in fix: added git worktree cleanup on errors gruntwork-io/terragrunt#5254
docs: Adding ambassador by @karlcarstensen in Adding ambassador gruntwork-io/terragrunt#5261
docs: Adding ambassador by @karlcarstensen in Adding ambassador gruntwork-io/terragrunt#5259
docs: Adding announcement banner by @karlcarstensen in Adding announcement banner gruntwork-io/terragrunt#5260
docs: Documenting backport of queue flags into filter flags by @yhakbar in docs: Documenting backport of queue flags into filter flags gruntwork-io/terragrunt#5263
docs: Adding ambassador by @karlcarstensen in Adding ambassador gruntwork-io/terragrunt#5266
chore: Cleaning up test symlinks resolution by @yhakbar in chore: Cleaning up test symlinks resolution gruntwork-io/terragrunt#5251
chore: Dropping ListContains and ListEquals and using standard library instead by @yhakbar in chore: Dropping ListContains and ListEquals and using standard library instead gruntwork-io/terragrunt#5221
chore: Adding debug log for assume already applied by @yhakbar in chore: Adding debug log for assume already applied gruntwork-io/terragrunt#5198
chore: Removing latest Terraform OSS workflows by @yhakbar in chore: Removing latest Terraform OSS workflows gruntwork-io/terragrunt#5262
chore: Backporting queue flags into filter flags by @yhakbar in chore: Backporting queue flags into filter flags gruntwork-io/terragrunt#5241
chore: on demand no proxy build execution by @denis256 in feat: on demand no proxy build execution gruntwork-io/terragrunt#5277
chore: opentelemetry and aws dependencies update by @denis256 in chore: opentelemetry and aws dependencies update gruntwork-io/terragrunt#5279

New Contributors

@philipmckenna-symphony made their first contribution in fix: get_original_terragrunt_dir during stack generate gruntwork-io/terragrunt#5176

Full Changelog: https://github.com/gruntwork-io/terragrunt/compare/v0.96.1..v.0.97.0

View the full release notes at https://github.com/gruntwork-io/terragrunt/releases/tag/v0.97.0.

---

[github-actions]

🤖 An automated task has requested bottles to be published to this PR.

Caution

Please do not push to this PR branch before the bottle commits have been pushed, as this results in a state that is difficult to recover from. If you need to resolve a merge conflict, please use a merge commit. Do not force-push to this PR branch.