You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/docs/language/upgrade-guides/index.mdx
+20-1Lines changed: 20 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,14 +14,33 @@ Terraform v1.7 honors the
14
14
but there are some behavior changes outside of those promises that may affect a
15
15
small number of users. Specifically, the following updates may require
16
16
additional upgrade steps:
17
-
*[Deprecated parameters for the S3 backend](#s3-backend)
17
+
*[Validations and checks in the state file](#validations-and-checks)
18
+
*[Deprecated parameters for the S3 backend](#s3-backend)
18
19
19
20
See [the full changelog](https://github.com/hashicorp/terraform/blob/v1.6/CHANGELOG.md)
20
21
for more details. If you encounter any problems during upgrading which are not
21
22
covered this guide, please start a new topic in
22
23
[the Terraform community forum](https://discuss.hashicorp.com/c/terraform-core)
23
24
to discuss it.
24
25
26
+
## Validations and Checks
27
+
28
+
Due to a state interoperability issue ([#33770](https://github.com/hashicorp/terraform/issues/33770), [#34014](https://github.com/hashicorp/terraform/issues/34014)) in earlier versions of Terraform, state files created by the Terraform v1.7.x series may not be compatible with the following Terraform versions:
29
+
30
+
* Terraform v1.3.0 through v1.3.9
31
+
* Terraform v1.4.0 through v1.4.6
32
+
* Terraform v1.5.0 through v1.5.6
33
+
34
+
If your v1.7.x state file contains `check` blocks or input validations, it will not be compatible with the above versions. Attempting to load a state file created by Terraform v1.7.x in one of the above versions will result in an error similar to `Error refreshing state: unsupported checkable object "var"`. This will particularly affect configurations using the `terraform_remote_state` data source to load state files created by the `v1.7.x` series.
35
+
36
+
To prevent this issue, users should upgrade any usage of the affected versions to the following patch releases in the relevant minor release series before attempting to process state files created by Terraform v1.7.x:
37
+
38
+
* Terraform v1.3.x series users should upgrade to v1.3.10
39
+
* Terraform v1.4.x series users should upgrade to v1.4.7
40
+
* Terraform v1.5.x series users should upgrade to v1.5.7
41
+
42
+
Terraform versions prior to v1.3.0 and equal to or after v1.6.0 are not affected by this issue.
43
+
25
44
## S3 Backend
26
45
27
46
In Terraform 1.7.0 the S3 backend will begin phasing out the legacy credential chain evaluation order by defaulting `use_legacy_workflow` to `false` and deprecating the argument.
0 commit comments