1.7.0-alpha20231130 (November 30, 2023)
UPGRADE NOTES:
-
Input validations are being restored to the state file in this version of Terraform. Due to a state interoperability issue (#33770) in earlier versions, users that require interaction between different minor series should ensure they have upgraded to the following patches:
- Users of Terraform prior to 1.3.0 are unaffected;
- Terraform 1.3 series users should upgrade to 1.3.10;
- Terraform 1.4 series users should upgrade to 1.4.7;
- Terraform 1.5 series users should upgrade to 1.5.7;
- Users of Terraform 1.6.0 and later are unaffected.
This is important for users with
terraform_remote_state
data sources reading remote state across different versions of Terraform. -
nonsensitive
function no longer raises an error when applied to a value that is already non-sensitive. (#33856) -
terraform graph
now produces a simplified graph describing only relationships between resources by default, for consistency with the granularity of information returned by other commands that emphasize resources as the main interesting object type and de-emphasize the other "glue" objects that connect them.The type of graph that earlier versions of Terraform produced by default is still available with explicit use of the
-type=plan
option, producing an approximation of the real dependency graph Terraform Core would use to construct a plan. -
terraform test
: Simplify the ordering of destroy operations during test cleanup to simple reverse run block order. (#34293)
NEW FEATURES:
-
terraform test
: Providers, modules, resources, and data sources can now be mocked during executions ofterraform test
. The following new blocks have been introduced within.tftest.hcl
files:mock_provider
: Can replace provider instances with mocked providers, allowing tests to execute incommand = apply
mode without requiring a configured cloud provider account and credentials. Terraform will create fake resources for mocked providers and maintain them in state for the lifecycle of the given test file.override_resource
: Specific resources can be overridden so Terraform will create a fake resource with custom values instead of creating infrastructure for the overridden resource.override_data
: Specific data sources can be overridden so data can be imported into tests without requiring real infrastructure to be created externally first.override_module
: Specific modules can be overridden in their entirety to give greater control over the returned outputs without requiring in-depth knowledge of the module itself.
-
removed
block for refactoring modules: Module authors can now record in source code when a resource or module call has been removed from configuration, and can inform Terraform whether the corresponding object should be deleted or simply removed from state.This effectively provides a configuration-driven workflow to replace
terraform state rm
. Removing an object from state is a new type of action which is planned and applied like any other. Theterraform state rm
command will remain available for scenarios in which directly modifying the state file is appropriate.
BUG FIXES:
- Ignore potential remote terraform version mismatch when running force-unlock (#28853)
- Exit Dockerfile build script early on
cd
failure. (#34128)
ENHANCEMENTS:
terraform test
: Providers defined within test files can now reference variables from their configuration that are defined within the test file. (#34069)terraform test
: Providers defined within test files can now reference outputs from run blocks. (#34118)terraform test
: Terraform functions are now available within variables and provider blocks within test files. (#34204)terraform graph
: Now produces a simplified resources-only graph by default. (#34288)import
:for_each
can now be used to expand theimport
block to handle multiple resource instances (#33932)- If the proposed change for a resource instance is rejected either due to a
postcondition
block or aprevent_destroy
setting, Terraform will now include that proposed change in the plan output alongside the relevant error, whereas before the error would replace the proposed change in the output. (#34312)
Previous Releases
For information on prior major and minor releases, see their changelogs: