github.com/terramate-io/tf@v0.0.0-20230830114523-fce866b4dfcd/website/docs/language/upgrade-guides/index.mdx (about)

     1  ---
     2  page_title: Upgrading to Terraform v1.5
     3  description: Upgrading to Terraform v1.5
     4  ---
     5  
     6  # Upgrading to Terraform v1.5
     7  
     8  -> **Tip:** Use the version selector to view the upgrade guides for older Terraform versions.
     9  
    10  Terraform v1.5 is a minor release in the stable Terraform v1.0 series.
    11  
    12  Terraform v1.5 honors the
    13  [Terraform v1.0 Compatibility Promises](https://developer.hashicorp.com/terraform/language/v1-compatibility-promises),
    14  but there are some behavior changes outside of those promises that may affect a
    15  small number of users. Specifically, the following updates may require
    16  additional upgrade steps:
    17  * [End of support for older macOS releases](#end-of-support-for-older-macos-releases)
    18  * [Linux DNS resolver changes](#linux-dns-resolver-changes)
    19  
    20  See [the full changelog](https://github.com/hashicorp/terraform/blob/v1.5/CHANGELOG.md)
    21  for more details. If you encounter any problems during upgrading which are not
    22  covered this guide, please start a new topic in
    23  [the Terraform community forum](https://discuss.hashicorp.com/c/terraform-core)
    24  to discuss it.
    25  
    26  ## End of support for older macOS releases
    27  
    28  Terraform v1.5 will be the last release supported on macOS 10.13 High Sierra
    29  and macOS 10.14 Mojave, both of which are no longer maintained by Apple.
    30  
    31  Terraform v1.5 itself supports these older macOS versions, but we strongly
    32  recommend upgrading during the v1.5 release period so that you'll be ready to
    33  use Terraform v1.6 once it is released.
    34  
    35  ## Linux DNS resolver changes
    36  
    37  Terraform on Linux uses a built-in DNS resolver rather than using the DNS
    38  resolver from the platform's C library, because this allows Terraform to run
    39  on systems with many different C libraries.
    40  
    41  In Terraform v1.5, the DNS resolver will now notice when you have set the
    42  `trust-ad` option in your `/etc/resolve.conf` file, and will respond by setting
    43  the "authentic data" option in outgoing DNS requests to better match the
    44  behavior of the GNU libc DNS resolver.
    45  
    46  Terraform does not pay any attention to the corresponding option in responses,
    47  but some DNSSEC-aware recursive resolvers return different responses when the
    48  request option isn't set. This should therefore avoid some potential situations
    49  where a DNS request from Terraform might get a different response than a
    50  similar request from other software on your system.
    51  
    52  We don't expect this behavior change to be significant for most Terraform users.
    53  
    54  Note that this change affects only DNS requests made by Terraform CLI itself,
    55  and not requests made by providers. Provider plugins are separate programs
    56  which handle DNS resolution themselves and so may have different behavior.