BUG FIXES:
terraform test
: Stop attempting to destroy run blocks that have no actual infrastructure to destroy. This fixes an issue where attempts to destroy "verification" run blocks that load only data sources would fail if the underlying infrastructure referenced by the run blocks had already been destroyed. (#34331)- cloud: prevent running saved cloud plans in VCS-connected workspaces. Saved plans might be applied later, and VCS workspaces shouldn't apply configurations that don't come from their designated VCS branch.
- core: Unmanaged plugins (mainly used by provider acceptance testing) would not have a provider address set, preventing the caching of their schemas (#34380)
BUG FIXES:
- backend/s3: Fixes parsing errors in shared config and credentials files. (#34313)
- backend/s3: Fixes error with AWS SSO when using FIPS endpoints. (#34313)
ENHANCEMENTS:
- backend/s3: Add the parameter
endpoints.sso
to allow overriding the AWS SSO API endpoint. (#34195)
BUG FIXES:
terraform test
: Fix bug preventing passing sensitive output values from previous run blocks as inputs to future run blocks. (#34190)- backend/s3: Add
https_proxy
andno_proxy
parameters to allow fully specifying proxy configuration (#34243)
ENHANCEMENTS:
- backend/s3: Adds the parameter
skip_s3_checksum
to allow users to disable checksum on S3 uploads for compatibility with "S3-compatible" APIs. (#34127)
BUG FIXES
terraform test
: Fix performance issues when using provisioners within configs being tested. (#34026)terraform test
: Only process and parse relevant variables for each run block. (#34072)- Fix occasional crash when destroying configurations with variables containing validations. (#34101)
- Fix interoperability issues between v1.6 series and earlier series by removing variable validations from the state file (#34058).
- cloud: Fixes panic when saving state in Terraform Cloud when certain types of API errors are returned (#34074).
- config: Fix crash in conditional statements with certain combinations of unknown values. Improve handling of refined values into the conditional expression results (#34096)
- config: Update HCL to fix bug when decoding objects with optional attributes (#34108)
- backend/s3: Some configurations would require
-reconfigure
during eachinit
when config was not decoded correctly (#34108)
ENHANCEMENTS:
- backend/s3: The
skip_requesting_account_id
argument supports AWS API implementations that do not have the IAM, STS, or metadata API. (#34002)
BUG FIXES:
- config: Using sensitive values as one or both of the results of a conditional expression will no longer crash. (#33996)
- config: Conditional expression returning refined-non-null result will no longer crash. (#33996)
- cli: Reverted back to previous behavior of ignoring signing key expiration for provider installation, since it's the provider registry's responsibility to verify key validity at publication time. (#34004)
- cli:
GIT_SSH_COMMAND
is now preserved again when fetching modules from git source addresses. (#34045) - cloud: The
TF_WORKSPACE
environment variable works with thecloud
block again; it can specify a workspace when none is configured, or select an active workspace when the config specifiestags
. (#34012) - backend/s3: S3, DynamoDB, IAM, and STS endpoint parameters will no longer fail validation if the parsed scheme or hostname is empty. (#34017)
- backend/s3: Providing a key alias to the
kms_key_id
argument will no longer fail validation. (#33993)
UPGRADE NOTES:
- On macOS, Terraform now requires macOS 10.15 Catalina or later; support for previous versions has been discontinued.
- On Windows, Terraform now requires at least Windows 10 or Windows Server 2016; support for previous versions has been discontinued.
- The S3 backend has a number of significant changes to its configuration format in this release, intended to match with recent changes in the
hashicorp/aws
provider:- Configuration settings related to assuming IAM roles now belong to a nested block
assume_role
. The top-level argumentsrole_arn
,session_name
,external_id
,assume_role_duration_seconds
,assume_role_policy_arns
,assume_role_tags
, andassume_role_transitive_tag_keys
are all now deprecated in favor of the nested equivalents. (#30495) - Configuration settings related to overriding the locations of AWS service endpoints used by the provider now belong to a nested block
endpoints
. The top-level argumentsdynamodb_endpoint
,iam_endpoint
,endpoint
(fir S3), andsts_endpoint
are now deprecated in favor of the nested equivalents. (#30492) - The backend now uses the following environment variables for overriding the default locations of AWS service endpoints used by the provider:
AWS_ENDPOINT_URL_DYNAMODB
,AWS_ENDPOINT_URL_IAM
,AWS_ENDPOINT_URL_S3
, andAWS_ENDPOINT_URL_STS
. The old non-standard names for these environment variables are now deprecated:AWS_DYNAMODB_ENDPOINT
,AWS_IAM_ENDPOINT
,AWS_S3_ENDPOINT
, andAWS_STS_ENDPOINT
. (#30479) - The singular
shared_credentials_file
argument is deprecated in favor of the pluralshared_credentials_files
. - The
force_path_style
argument is deprecated in favor ofuse_path_style
for consistency with the AWS SDK. (#30491)
- Configuration settings related to assuming IAM roles now belong to a nested block
NEW FEATURES:
-
terraform test
: Theterraform test
command is now generally available. This comes with a significant change to how tests are written and executed, based on feedback from the experimental phase.Terraform tests are written in
.tftest.hcl
files, containing a series ofrun
blocks. Eachrun
block executes a Terraform plan and optional apply against the Terraform configuration under test and can check conditions against the resulting plan and state.
ENHANCEMENTS:
- config: The
import
blockid
field now accepts expressions referring to other values such as resource attributes, as long as the value is a string known at plan time. (#33618) - Terraform Cloud integration: Remote plans on Terraform Cloud/Enterprise can now be saved using the
-out
option, viewed usingterraform show
, and applied usingterraform apply
with the saved plan filename. (#33492) - config: Terraform can now track some additional detail about values that won't be known until the apply step, such as the range of possible lengths for a collection or whether an unknown value can possibly be null. When this information is available, Terraform can potentially generate known results for some operations on unknown values. This doesn't mean that Terraform can immediately track that detail in all cases, but the type system now supports that and so over time we can improve the level of detail generated by built-in functions, language operators, Terraform providers, etc. (#33234)
- core: Provider schemas can now be cached globally for compatible providers, allowing them to be reused throughout core without requesting them for each new provider instance. This can significantly reduce memory usage when there are many instances of the same provider in a single configuration (#33482)
- config: The
try
andcan
functions can now return more precise and consistent results when faced with unknown arguments (#33758) terraform show -json
: Now includeserrored
property, indicating whether the planning process halted with an error. An errored plan is not applyable. (#33372)- core: Terraform will now skip requesting the (possibly very large) provider schema from providers which indicate during handshake that they don't require that for correct behavior, in situations where Terraform Core itself does not need the schema. (#33486)
- backend/kubernetes: The Kubernetes backend is no longer limited to storing states below 1MiB in size, and can now scale by splitting state across multiple secrets. (#29678)
- backend/s3: Various improvements for consistency with
hashicorp/aws
provider capabilities:assume_role_with_web_identity
nested block for assuming a role with dynamic credentials such as a JSON Web Token. (#31244)- Now honors the standard AWS environment variables for credential and configuration files:
AWS_CONFIG_FILE
andAWS_SHARED_CREDENTIALS_FILE
. (#30493) shared_config_files
andshared_credentials_files
arguments for specifying credential and configuration files as part of the backend configuration. (#30493)- Internally the backend now uses AWS SDK for Go v2, which should address various other missing behaviors that are handled by the SDK rather than by Terraform itself. (#30443)
custom_ca_bundle
argument and support for the corresponding AWS environment variable,AWS_CA_BUNDLE
, for providing custom root and intermediate certificates. (#33689)ec2_metadata_service_endpoint
andec2_metadata_service_endpoint_mode
arguments and support for the corresponding AWS environment variables,AWS_EC2_METADATA_SERVICE_ENDPOINT
andAWS_EC2_METADATA_SERVICE_ENDPOINT_MODE
for setting the EC2 metadata service (IMDS) endpoint. The environment variableAWS_METADATA_URL
is also supported for compatibility with the AWS provider, but is deprecated. (#30444)http_proxy
,insecure
,use_fips_endpoint
, anduse_dualstack_endpoint
arguments and support for the corresponding environment variables,HTTP_PROXY
andHTTPS_PROXY
, which enable custom HTTP proxy configurations and the resolution of AWS endpoints with extended capabilities. (#30496)sts_region
argument to use an alternative region for STS operations. (#33693)retry_mode
argument and support for the correspondingAWS_RETRY_MODE
environment variable to configure how retries are attempted. (#33692)allowed_account_ids
andforbidden_account_ids
arguments to prevent unintended modifications to specified environments. (#33688)
- backend/cos: Support custom HTTP(S) endpoint and root domain for the API client. (#33656)
BUG FIXES:
- core: Transitive dependencies were lost during apply when the referenced resource expanded into zero instances. (#33403)
- cli: Terraform will no longer override SSH settings in local git configuration when installing modules. (#33592)
terraform
built-in provider: The upstream dependency that Terraform uses for service discovery of Terraform-native services such as Terraform Cloud/Enterprise state storage was previously not concurrency-safe, but Terraform was treating it as if it was in situations like when a configuration has multipleterraform_remote_state
blocks all using the "remote" backend. Terraform is now using a newer version of that library which updates its internal caches in a concurrency-safe way. (#33364)terraform init
: Terraform will no longer allow downloading remote modules to invalid paths. (#33745)- Ignore potential remote terraform version mismatch when running force-unlock (#28853)
- cloud: Fixed a bug that would prevent nested symlinks from being dereferenced into the config sent to Terraform Cloud (#31895)
- cloud: state snapshots could not be disabled when header x-terraform-snapshot-interval is absent (#33820)
For information on prior major and minor releases, see their changelogs: