IntenseWebs/opentofu
3
0
Fork 0
mirror of https://github.com/opentofu/opentofu.git synced 2024-12-28 01:41:48 -06:00
Code Issues Packages Projects Releases Wiki Activity

Update website/docs/language/upgrade-guides (#239)

Browse Source 
Signed-off-by: Marcin Białoń <mbialon@spacelift.io>
This commit is contained in:
Marcin Białoń 2023-08-30 00:00:45 +02:00 committed by GitHub
parent acef30c7b7
commit be5ce291f4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
website/docs/language/upgrade-guides/index.mdx
View File

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