Skip to content

Commit

Permalink
clarify website docs for 3.x upgrade
Browse files Browse the repository at this point in the history
  • Loading branch information
jacobbednarz committed Sep 20, 2021
1 parent 5843ddd commit c7334d8
Showing 1 changed file with 5 additions and 10 deletions.
15 changes: 5 additions & 10 deletions website/docs/guides/version-3-upgrade.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,16 +42,11 @@ and `sed` for simple replacements however we will be providing examples using
structure. NB: the attached examples are intentionally simple and you may want
to make them more specific to suit your use case or environment.

As some schema changes have been made, this will also mean the state
representation could have changed. In these scenarios, it is recommended that
you either:

1. Recreate the resources using the newer version of the schema; or
2. Manually update the state files to reflect the new structure.

We opted not to perform schema migrations on behalf of the end user as the
changes from `TypeMap` to `TypeList` introduced many validation improvements
which may weed out malformed resources, and we couldn't cover all edge cases.
As some schema changes have been made, state migrators have been included in the
newer versions. As the majority of the changes are `TypeMap` => `TypeList` we
recommend verifying the upgrade yourself on a non-production resource first
as `TypeMap` did include some undocumented behaviour which has been removed in
`terraform-sdk-plugin` v2 and will not be the same across the versions.

## Terraform 0.13 and older versions no longer supported

Expand Down

0 comments on commit c7334d8

Please sign in to comment.