From 44c1d0e1e6d822b4c832519402f484ba9656583d Mon Sep 17 00:00:00 2001 From: Zach Goldberg Date: Thu, 23 Oct 2025 11:00:09 -0700 Subject: [PATCH 1/4] Update upgrading-github-v3-to-v4.md --- .../previous-versions/upgrading-github-v3-to-v4.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md index 853bd1934..311b17471 100644 --- a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md +++ b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md @@ -27,6 +27,17 @@ The following [feature flags](https://docs.gruntwork.io/2.0/reference/pipelines/ * PIPELINES_FEATURE_EXPERIMENT_COLOCATED_FILE_UNIT_CHANGE_DETECTION * PIPELINES_FEATURE_EXPERIMENT_MINIMIZE_BLAST_RADIUS +## `--queue-include-units-reading` used instead of `--units-that-include` + +Pipelines will now always use `--queue-include-units-reading` instead of `--units-that-include`. + +Previously, Pipelines would only use the former flag for `FileChanged` events for the sake of providing greater backwards compatibility, but the minimum supported version of Terragrunt in Pipelines now supports `--units-that-include`, and this is no longer necessary. + +By making this change, Pipelines now behaves more in-line with customer expectations, as customers expect that a file with an `.hcl` extension read via an HCL function like `read_terragrunt_config()` should still result in inclusion into the run queue. + +## Updated Terminology: Module -> Unit +Pipelines v4 now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. + # Migration Guide ## Updating Terragrunt Version From 6937cb839e7100b7299fe5c380e43a081938a667 Mon Sep 17 00:00:00 2001 From: Zach Goldberg Date: Thu, 23 Oct 2025 11:01:18 -0700 Subject: [PATCH 2/4] Update gitlab as well --- .../previous-versions/upgrading-github-v3-to-v4.md | 4 ++-- .../previous-versions/upgrading-gitlab-v1-to-v2.md | 11 +++++++++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md index 311b17471..474313408 100644 --- a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md +++ b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md @@ -27,7 +27,7 @@ The following [feature flags](https://docs.gruntwork.io/2.0/reference/pipelines/ * PIPELINES_FEATURE_EXPERIMENT_COLOCATED_FILE_UNIT_CHANGE_DETECTION * PIPELINES_FEATURE_EXPERIMENT_MINIMIZE_BLAST_RADIUS -## `--queue-include-units-reading` used instead of `--units-that-include` +### `--queue-include-units-reading` used instead of `--units-that-include` Pipelines will now always use `--queue-include-units-reading` instead of `--units-that-include`. @@ -35,7 +35,7 @@ Previously, Pipelines would only use the former flag for `FileChanged` events fo By making this change, Pipelines now behaves more in-line with customer expectations, as customers expect that a file with an `.hcl` extension read via an HCL function like `read_terragrunt_config()` should still result in inclusion into the run queue. -## Updated Terminology: Module -> Unit +### Updated Terminology: Module -> Unit Pipelines v4 now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. # Migration Guide diff --git a/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md b/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md index 93de6ca06..e073e0fb0 100644 --- a/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md +++ b/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md @@ -27,6 +27,17 @@ The following [feature flags](https://docs.gruntwork.io/2.0/reference/pipelines/ * PIPELINES_FEATURE_EXPERIMENT_COLOCATED_FILE_UNIT_CHANGE_DETECTION * PIPELINES_FEATURE_EXPERIMENT_MINIMIZE_BLAST_RADIUS +### `--queue-include-units-reading` used instead of `--units-that-include` + +Pipelines will now always use `--queue-include-units-reading` instead of `--units-that-include`. + +Previously, Pipelines would only use the former flag for `FileChanged` events for the sake of providing greater backwards compatibility, but the minimum supported version of Terragrunt in Pipelines now supports `--units-that-include`, and this is no longer necessary. + +By making this change, Pipelines now behaves more in-line with customer expectations, as customers expect that a file with an `.hcl` extension read via an HCL function like `read_terragrunt_config()` should still result in inclusion into the run queue. + +### Updated Terminology: Module -> Unit +Pipelines v4 now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. + # Migration Guide To upgrade Pipelines from v1 to v2, perform the following changes in each repository that includes the Gruntwork Pipelines Workflows. From 413ee8576de45bf4a02a22563b47300e74967c02 Mon Sep 17 00:00:00 2001 From: Zach Goldberg Date: Thu, 23 Oct 2025 11:01:46 -0700 Subject: [PATCH 3/4] Update upgrading-gitlab-v1-to-v2.md --- .../pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md b/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md index e073e0fb0..eedc3b0de 100644 --- a/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md +++ b/docs/2.0/docs/pipelines/previous-versions/upgrading-gitlab-v1-to-v2.md @@ -36,7 +36,7 @@ Previously, Pipelines would only use the former flag for `FileChanged` events fo By making this change, Pipelines now behaves more in-line with customer expectations, as customers expect that a file with an `.hcl` extension read via an HCL function like `read_terragrunt_config()` should still result in inclusion into the run queue. ### Updated Terminology: Module -> Unit -Pipelines v4 now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. +Pipelines now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. # Migration Guide To upgrade Pipelines from v1 to v2, perform the following changes in each From eec934b2c0ea9bc78fcdde394de4d90115d2dedb Mon Sep 17 00:00:00 2001 From: Zach Goldberg Date: Thu, 23 Oct 2025 11:02:00 -0700 Subject: [PATCH 4/4] Update upgrading-github-v3-to-v4.md --- .../pipelines/previous-versions/upgrading-github-v3-to-v4.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md index 474313408..93ef09819 100644 --- a/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md +++ b/docs/2.0/docs/pipelines/previous-versions/upgrading-github-v3-to-v4.md @@ -36,7 +36,7 @@ Previously, Pipelines would only use the former flag for `FileChanged` events fo By making this change, Pipelines now behaves more in-line with customer expectations, as customers expect that a file with an `.hcl` extension read via an HCL function like `read_terragrunt_config()` should still result in inclusion into the run queue. ### Updated Terminology: Module -> Unit -Pipelines v4 now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. +Pipelines now refers to leaf folders with a `terragrunt.hcl` file as `units`. Prior versions used the term `module`. This change aligns Pipelines' terminology with Terragrunt's. # Migration Guide