Skip to content

terragrunt 0.88.0#245833

Merged
BrewTestBot merged 2 commits intomainfrom
bump-terragrunt-0.88.0
Sep 26, 2025
Merged

terragrunt 0.88.0#245833
BrewTestBot merged 2 commits intomainfrom
bump-terragrunt-0.88.0

Conversation

@BrewTestBot
Copy link
Copy Markdown
Contributor

Created by brew bump


Created with brew bump-formula-pr.

Details

release notes
## 🛠️ Breaking Changes

Default Command Forwarding Removed

Terragrunt no longer forwards unknown top‑level commands to OpenTofu by default.

Invoking an unknown command now fails with guidance to use the explicit run form.

This is the next step in the removal of deprecated features in Terragrunt on the road to Terragrunt 1.0, with more to follow. Read the CLI Redesign migration guide for guidance on adapting to future breaking changes.

For a full list of deprecated features that will be removed prior to the release of Terragrunt 1.0, see the removal schedule.

❌ Old Behavior (Deprecated)

terragrunt workspace ls
terragrunt graph

✅ New Behavior

terragrunt run -- workspace ls
terragrunt run -- graph

🔧 Migration Guide

Keep using shortcuts for common commands:

terragrunt plan
terragrunt apply

Replace usage of any OpenTofu/Terraform command that isn’t a supported shortcut with explicit usage of the run command:

terragrunt workspace ls => terragrunt run -- workspace ls
terragrunt graph => terragrunt run -- graph

When mixing Terragrunt and OpenTofu flags, separate them with --:

terragrunt run -- apply -auto-approve
terragrunt run -- output -json
terragrunt run --all -- plan -var foo=bar

Command-specific flags must be used after their commands

As part of the changes to remove the deprecated behavior of forwarding unknown commands to OpenTofu by default, users can no longer treat flags as global flags unless they are in-fact global flags.

For example, the following will still work:

terragrunt --log-level debug plan
terragrunt --no-color plan

But the following will no longer be supported:

terragrunt --provider-cache run --all plan

Instead, you must supply flags after the commands they are used by:

terragrunt run --all --provider-cache plan

Flag Scope Changes (backend + feature flags)

Backend migration and feature-related flags are now command-scoped and should appear after the relevant subcommand.

These flags are accepted on run, backend, scaffold, find, and list

Affected flags:

  • backend-bootstrap
  • backend-require-bootstrap
  • disable-bucket-update
  • feature key=value

❌ Old Behavior (Deprecated)

Command-specific flags could be set anywhere in the arguments for a command:

terragrunt --backend-bootstrap backend delete --all
terragrunt --feature stage=true plan

✅ New Behavior

Place flags after the respective command they control:

terragrunt backend bootstrap --backend-bootstrap
terragrunt plan --feature stage=true
terragrunt find --feature stage=true

🔧 Migration Guide

Move these flags to follow the subcommand they apply to

terragrunt --feature stage=true plan => terragrunt plan --feature stage=true

What's Changed

Full Changelog: gruntwork-io/terragrunt@v0.87.7...v0.88.0

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


@github-actions github-actions bot added go Go use is a significant feature of the PR or issue bump-formula-pr PR was created using `brew bump-formula-pr` labels Sep 26, 2025
@chenrui333 chenrui333 force-pushed the bump-terragrunt-0.88.0 branch from 608117c to bb18ae1 Compare September 26, 2025 18:29
@github-actions
Copy link
Copy Markdown
Contributor

🤖 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.

@github-actions github-actions bot added the CI-published-bottle-commits The commits for the built bottles have been pushed to the PR branch. label Sep 26, 2025
@BrewTestBot BrewTestBot added this pull request to the merge queue Sep 26, 2025
Merged via the queue into main with commit a42c85a Sep 26, 2025
22 checks passed
@BrewTestBot BrewTestBot deleted the bump-terragrunt-0.88.0 branch September 26, 2025 19:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bump-formula-pr PR was created using `brew bump-formula-pr` CI-published-bottle-commits The commits for the built bottles have been pushed to the PR branch. go Go use is a significant feature of the PR or issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants