Skip to content

Commit d646454

Browse files
committed
also call out state interoperability
1 parent d57df01 commit d646454

File tree

1 file changed

+20
-1
lines changed
  • website/docs/language/upgrade-guides

1 file changed

+20
-1
lines changed

website/docs/language/upgrade-guides/index.mdx

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,33 @@ Terraform v1.7 honors the
1414
but there are some behavior changes outside of those promises that may affect a
1515
small number of users. Specifically, the following updates may require
1616
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)
1819

1920
See [the full changelog](https://github.com/hashicorp/terraform/blob/v1.6/CHANGELOG.md)
2021
for more details. If you encounter any problems during upgrading which are not
2122
covered this guide, please start a new topic in
2223
[the Terraform community forum](https://discuss.hashicorp.com/c/terraform-core)
2324
to discuss it.
2425

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+
2544
## S3 Backend
2645

2746
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

Comments
 (0)