github.com/hugorut/terraform@v1.1.3/website/docs/language/upgrade-guides/1-0.mdx (about)

     1  ---
     2  page_title: Upgrading to Terraform v1.0
     3  description: Upgrading to Terraform v1.0
     4  ---
     5  
     6  # Upgrading to Terraform v1.0
     7  
     8  Terraform v1.0 is an unusual release in that its primary focus is on stability,
     9  and it represents the culmination of several years of work in previous major
    10  releases to make sure that the Terraform language and internal architecture
    11  will be a suitable foundation for forthcoming additions that will remain
    12  backward-compatible.
    13  
    14  Terraform v1.0.0 intentionally has no significant changes compared to Terraform
    15  v0.15.5. You can consider the v1.0 series as a direct continuation of the v0.15
    16  series.
    17  
    18  There are no special steps to take if you are upgrading from the previous
    19  major release, Terraform v0.15.
    20  
    21  You can also upgrade directly from Terraform v0.14 if you wish, although please
    22  still consider the notes from [the Terraform v0.15 upgrade guide](/language/upgrade-guides/0-15).
    23  If you are affected by the notes in that upgrade guide, you will still need to
    24  take the steps described there but you can do so as part of upgrading to v1.0,
    25  without any need for an intermediate step of running Terraform v0.15.
    26  
    27  If you are currently using Terraform v0.13 or earlier then we strongly
    28  recommend upgrading one major version at a time until you reach Terraform v0.14,
    29  following the upgrade guides of each of those versions, because those earlier
    30  versions include mechanisms to automatically detect necessary changes to your
    31  configuration, and in some cases also automatically edit your configuration
    32  to include those changes. One you reach Terraform v0.14 you can then skip
    33  directly from there to Terraform v1.0.
    34  
    35  The following table summarizes the above recommendations. In each case, we
    36  recommend using the latest patch release from each major version in order to
    37  complete your upgrade.
    38  
    39  | Current Version  | Recommendation                                                                                                                                                                                                                                                                                              |
    40  | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    41  | v0.10 or earlier | Refer to the upgrade guides for these historical versions until you have upgraded to the latest v0.11 release, then refer to the following item.                                                                                                                                                            |
    42  | v0.11            | Use [the `terraform 0.12checklist` command](/language/upgrade-guides/0-12#pre-upgrade-checklist) to detect any situations that must be addressed before upgrading to v0.12, resolve them, and then upgrade to the latest v0.12 release and follow [the v0.12 Upgrade Guide](/language/upgrade-guides/0-12). |
    43  | v0.12            | Upgrade to the latest Terraform v0.13 release and then follow [the v0.13 upgrade guide](/language/upgrade-guides/0-13) to upgrade your configuration and state for explicit provider requirements.                                                                                                          |
    44  | v0.13            | Upgrade to the latest Terraform v0.14 release and attempt a normal Terraform run. If you encounter any new errors, refer to [the v0.14 upgrade guide](/language/upgrade-guides/0-14) for resolution steps.                                                                                                  |
    45  | v0.14            | Upgrade directly to the latest Terraform v1.0 release and attempt a normal Terraform run. If you encounter any new errors, refer to [the v0.15 upgrade guide](/language/upgrade-guides/0-15) for resolution steps.                                                                                          |
    46  | v0.15            | Upgrade directly to the latest Terraform v1.0 release and attempt a normal Terraform run. Terraform v1.0 is a continuation of the v0.15 series, and so v1.0.0 and later are directly backward-compatible with Terraform v0.15.5.                                                                            |
    47  
    48  -> If you run into any problems during upgrading, please feel free to start a
    49  topic in [the Terraform community forum](https://discuss.hashicorp.com/c/terraform-core),
    50  describing the problem you've encountered in enough detail that other readers
    51  may be able to reproduce it and offer advice.
    52  
    53  ## Remote State Compatibility
    54  
    55  In a more complex system you might have multiple separate Terraform
    56  configurations that collaborate together using
    57  [the `terraform_remote_state` data source](/language/state/remote-state-data).
    58  
    59  In that case, it's typical for some configurations to be applied with a new
    60  version before others do, causing differences in the state snapshot format
    61  between your different configurations.
    62  
    63  If you are upgrading from Terraform v0.14 or Terraform v0.15 to Terraform v1.0
    64  then you can upgrade your configurations in any order, because all three of
    65  these versions have intercompatible state snapshot formats.
    66  
    67  Upgrading from v0.13 or earlier in a multi-configuration environment may
    68  require more explicit planning to ensure state snapshot compatibility. Please
    69  refer to the previous release upgrade guides for more information, and upgrade
    70  only one major version at a time until you reach Terraform v0.14.