9.4 KiB
0.15.0 (Unreleased)
BREAKING CHANGES:
-
Empty provider configuration blocks should be removed from modules. If a configuration alias is required within the module, it can be defined using the
configuration_aliases
argument withinrequired_providers
. Existing module configurations which were accepted but could produce incorrect or undefined behavior may now return errors when loading the configuration. [GH-27739] -
The
list
andmap
functions, both of which were deprecated since Terraform v0.12, are now removed. You can replace uses of these functions withtolist([...])
andtomap({...})
respectively. (#26818) -
Terraform now requires UTF-8 character encoding and virtual terminal support when running on Windows. This unifies Terraform's terminal handling on Windows with that of other platforms, as per Microsoft recommendations. Terraform previously required these terminal features on all other platforms, and now requires them on Windows too.
UTF-8 and virtual terminal support were introduced across various Windows 10 updates, and so Terraform is no longer officially supported on the original release of Windows 10 or on Windows 8 and earlier. However, there are currently no technical measures to artificially prevent Terraform from running on these obsolete Windows releases, and so you may still be able to use Terraform v0.15 on older Windows versions if you either disable formatting (using the
-no-color
) option, or if you use a third-party terminal emulator package such as ConEmu, Cmder, or mintty.We strongly encourage planning to migrate to a newer version of Windows rather than relying on these workarounds for the long term, because the Terraform team will test future releases only on up-to-date Windows 10 and can therefore not guarantee ongoing support for older versions.
-
Interrupting execution will now cause terraform to exit with a non-zero exit status. (#26738)
-
The trailing
[DIR]
argument to specify the working directory for various commands is no longer supported. Use the global-chdir
option instead. (#27664)For example, instead of
terraform init infra
, writeterraform -chdir=infra init
. -
The
-lock
and-lock-timeout
options are no longer available onterraform init
(#27464) -
The
-verify-plugins=false
option is no longer available onterraform init
. (Terraform now always verifies plugins.) (#27461) -
The
-get-plugins=false
option is no longer available onterraform init
. (Terraform now always installs plugins.) (#27463) -
The
-force
option is no longer available onterraform destroy
. Use-auto-approve
instead (#27681) -
terraform version -json
output no longer includes the (previously-unpopulated) "revision" property [#27484] -
The
atlas
backend, which was deprecated since Terraform v0.12, is now removed. (#26651) -
In the
gcs
backend thepath
config argument, which was deprecated since Terraform v0.11, is now removed. Use theprefix
argument instead. (#26841) -
The deprecated
ignore_changes = ["*"]
wildcard syntax will now error. Use= all
instead. [GH-27834] -
Previously deprecated quoted type strings will now error rather than warn - follow the instructions in the error message to update your type signatures to be more explicit. For example, use
map(string)
instead of"map"
. [GH-27852]
ENHANCEMENTS:
- backend/azurerm: updating the dependencies for the Azure Backend (#26721)
- config: A
required_providers
entry can now containconfiguration_aliases
to declare additional configuration aliases names without requirring a configuration block [GH-27739] - config: Terraform will now emit a warning if you declare a
backend
block in a non-root module. Terraform has always ignored such declarations, but previously did so silently. This is a warning rather than an error only because it is sometimes convenient to temporarily use a root module as if it were a child module in order to test or debug its behavior separately from its main backend. (#26954) - cli: The family of error messages with the summary "Invalid for_each argument" will now include some additional context about which external values contributed to the result. (#26747)
- cli: Terraform now uses UTF-8 and full VT mode even when running on Windows. Previously Terraform was using the "classic" Windows console API, which was far more limited in what formatting sequences it supported and which characters it could render. (#27487)
- cli: Improved support for Windows console UI on Windows 10, including bold colors and underline for HCL diagnostics. (#26588)
- cli: Diagnostic messages now have a vertical line along their left margin, which we hope will achieve a better visual hierarchy for sighted users and thus make it easier to see where the errors and warnings start and end in relation to other content that might be printed alongside. (#27343)
- cli: Typing an invalid top-level command, like
terraform destory
instead ofdestroy
, will now print out a specific error message about the command being invalid, rather than just printing out the usual help directory. (#26967) - cli: Plugin crashes will now be reported with more detail, pointing out the plugin name and the method call along with the stack trace (#26694)
- cli: Values in files for undeclared variables (ex.
tfvars
) are no longer deprecated, but will continue to produce a warning. The number of warnings produced has been reduced from 3 full warnings before a summary to two. To provide "global" values across configurations, useTF_VAR...
environment variables. To reduce the verbosity of the warnings, use the existing-compact-warnings
option. [GH-27795] - cli: The cli now handles structured logs throughout, allowing for additional log context from providers to be maintained, and offering new options for output filters. (#26632)
- cli: Core and Provider logs can now be enabled separately for debugging, using
TF_LOG_CORE
andTF_LOG_PROVIDER
(#26685) - Removed warning surrounding interpolation-only expressions - many of these are caught by
fmt
and we are removing the warning rather than upgrading it to an error [GH-27835]
BUG FIXES:
- backend/azure: azure state refreshes outside of grabbing the lock (#26561)
- cli: Exit with an error if unable to gather input from the UI. For example, this may happen when running in a non-interactive environment but without
-input=false
. Previously Terraform would interpret these errors as empty strings, which could be confusing. (#26509) - cli: TF_LOG levels other than
trace
will now work correctly (#26632) - command/console: expressions using
path
(path.root
,path.module
) now return the same result as they would in a configuration (#27263) - command/show: fix issue with child_modules not properly displaying in certain circumstances (#27352)
- command/state list: fix bug where nested modules' resources were missing from
state list
output (#27268) - command/state mv: fix display names in errors and improve error when failing to target a whole resource (#27482)
- command/taint: show resource name in -allow-missing warning (#27501)
- command/untaint: show resource name in -allow-missing warning (#27502)
- core: validate will now ignore providers without configuration (#24896)
- core: refresh data sources during destroy (#27408)
- core: fix missing deposed object ID in apply logs [GH-27796]
Previous Releases
For information on prior major releases, see their changelogs: