github.com/muratcelep/terraform@v1.1.0-beta2-not-internal-4/website/upgrade-guides/1-0.html.markdown (about)

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