docs: create_before_destroy meta-attribute propagation

hashicorp · Jul 21, 2023 · 1287ad4 · 1287ad4
1 parent ad26644
commit 1287ad4
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/website/docs/language/meta-arguments/lifecycle.mdx b/website/docs/language/meta-arguments/lifecycle.mdx
@@ -49,6 +49,13 @@ The arguments available within a `lifecycle` block are `create_before_destroy`,
   such features, so you must understand the constraints for each resource
   type before using `create_before_destroy` with it.
 
+  Note that Terraform propagates and applies `create_before_destroy` meta-attribute
+  behaviour to all resource dependencies. For example, if resource A with enabled
+  `create_before_destroy` depends on resource B with disabled `create_before_destroy`
+  (by default), then Terraform enables `create_before_destroy` for resource B
+  implicitly and stores it to the state file. You cannot override `create_before_destroy`
+  to `false` on resource B, because that would imply dependency cycles in the graph.
+
   Destroy provisioners of this resource do not run if `create_before_destroy`
   is set to `true`. This [GitHub issue](https://github.com/hashicorp/terraform/issues/13549) contains more details.