gruntwork-io / terragrunt

Terragrunt is a flexible orchestration tool that allows Infrastructure as Code written in OpenTofu/Terraform to scale.
https://terragrunt.gruntwork.io/
MIT License
8.1k stars 986 forks source link

feat: Deprecating `terragrunt.hcl` as root #3588

Open yhakbar opened 4 days ago

yhakbar commented 4 days ago

Description

Making it so that usage of a root terragrunt.hcl throws a warning for users, and gives them guidance to move to a differently named root configuration file.

Lots of docs updates necessary.

There are also considerations for Catalog/Scaffold that have to be taken into account.

TODOs

Read the Gruntwork contribution guidelines.

Release Notes (draft)

Updated strict package. Updated config package.

Migration Guide

Current idiomatic usage of Terragrunt involves using a root configuration file named terragrunt.hcl.

This causes a lot of confusion for users, and potential errors. With this change, the new recommendation of naming it anything else will be enforced via the strict package.

It will likely take a very long time before this functionality can be removed, so we should start updating our documentation to reflect this change and throw warnings that users are using less reliable configurations.