sincecutoff.com
← all changes

terragrunt catalog discovery and filtering with catalog-redesign

Introduced 2026-04-27 · score 0.98

HOW TO USE IT

When using Terragrunt v1.0.3 catalog discovery, enable the `catalog-redesign` experiment and run `terragrunt catalog`; add root `.terragrunt-catalog-ignore` rules to exclude paths. For extra rules, use `--ignore-file <path>` or `TG_IGNORE_FILE`; the docs confirm the command and ignore behavior, but not the experiment requirement at v1.0.3.

terragrunt catalog
terragrunt catalog --ignore-file <path>

WHY THIS HELPS

Discover modules and templates across a repository and exclude selected paths from the catalog.

REQUIREMENTS AND LIMITATIONS

  • Version: v1.0.3
  • Availability: The `catalog-redesign` experiment is required.
  • --ignore-file <path>: Path to an additional ignore file; its rules are appended after root `.terragrunt-catalog-ignore` rules, and the file must exist.
  • TG_IGNORE_FILE: Environment-variable alternative to `--ignore-file`.
  • Prerequisite: The docs describe `catalog-redesign` behavior as default in v1.1, with no experiment required; they do not document v1.0.3's experiment prerequisite.
  • Ignore patterns are anchored at the repository root, one per line; `#` starts a comment, `!` negates, and the last match wins.
  • A lone `*` does not cross `/`; `**` does.
  • A directory that qualifies as both a template and a module is classified as a template.
  • Docs conflict: Current docs describe default catalog behavior at v1.1, later than the card's v1.0.3; they do not verify its experiment switch or v1.0.3 usage.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card