Terraform enables you to safely and predictably create, change, and improve infrastructure. It is a source-available tool that codifies APIs into declarative configuration files that can be shared amongst team members, treated as code, edited, reviewed, and versioned.
EXPERIMENTS:
Experiments are only enabled in alpha releases of Terraform CLI. The following features are not yet available in stable releases.
ephemeral_values
: This language experiment introduces a new special kind of value which Terraform allows to change between the plan phase and the apply phase, and between plan/apply rounds. Ephemeral values are never persisted in saved plan files or state snapshots, and so can only be used in parts of the language that don't require values to persist in those artifacts. Ephemeral input values are the main initial example of this concept, allowing the use of input variables to provide dynamic credentials that must change between plan and apply.terraform test
accepts a new option -junit-xml=FILENAME
. If specified, and if the test configuration is valid enough to begin executing, then Terraform writes a JUnit XML test result report to the given filename, describing similar information as included in the normal test output. (#34291)terraform rpcapi
exposes some Terraform Core functionality through an RPC interface compatible with go-plugin
. The exact RPC API exposed here is currently subject to change at any time, because it's here primarily as a vehicle to support the Terraform Stacks private preview and so will be broken if necessary to respond to feedback from private preview participants, or possibly for other reasons. Do not use this mechanism yet outside of Terraform Stacks private preview.-allow-deferral
option to terraform plan
, permits count
and for_each
arguments in module
, resource
, and data
blocks to have unknown values and allows providers to react more flexibly to unknown values. This experiment is under active development, and so it's not yet useful to participate in this experimentFor information on prior major and minor releases, refer to their changelogs:
EXPERIMENTS:
Experiments are only enabled in alpha releases of Terraform CLI. The following features are not yet available in stable releases.
ephemeral_values
: This language experiment introduces a new special kind of value which Terraform allows to change between the plan phase and the apply phase, and between plan/apply rounds. Ephemeral values are never persisted in saved plan files or state snapshots, and so can only be used in parts of the language that don't require values to persist in those artifacts. Ephemeral input values are the main initial example of this concept, allowing the use of input variables to provide dynamic credentials that must change between plan and apply.terraform test
accepts a new option -junit-xml=FILENAME
. If specified, and if the test configuration is valid enough to begin executing, then Terraform writes a JUnit XML test result report to the given filename, describing similar information as included in the normal test output. (#34291)terraform rpcapi
exposes some Terraform Core functionality through an RPC interface compatible with go-plugin
. The exact RPC API exposed here is currently subject to change at any time, because it's here primarily as a vehicle to support the Terraform Stacks private preview and so will be broken if necessary to respond to feedback from private preview participants, or possibly for other reasons. Do not use this mechanism yet outside of Terraform Stacks private preview.-allow-deferral
option to terraform plan
, permits count
and for_each
arguments in module
, resource
, and data
blocks to have unknown values and allows providers to react more flexibly to unknown values. This experiment is under active development, and so it's not yet useful to participate in this experimentFor information on prior major and minor releases, refer to their changelogs:
BUG FIXES:
terraform test
: Remove duplicate warning diagnostic when providing values for unknown variables in run blocks. (#35172)NEW FEATURES:
templatestring
function: a new built-in function which is similar to templatefile
but designed to render templates obtained dynamically, such as from a data resource result.ENHANCEMENTS:
terraform plan
: Improved presentation of OPA and Sentinel policy evaluations in HCP Terraform remote runs, for logical separation.terraform init
now accepts a -json
option. If specified, enables the machine readable JSON output. (#34886)terraform test
: Test runs can now pass sensitive values to input variables while preserving their dynamic sensitivity. Previously sensitivity would be preserved only for variables statically declared as being sensitive, using sensitive = true
. (#35021)resource
blocks. (#35088)terraform
provider: Allows moved
block refactoring from the hashicorp/null
provider null_resource
resource type to the terraform_data
resource type. (#35163)terraform output
with cloud
block: Terraform no longer suggests that data loss could occur when outputs are not available. (#35143)terraform console
: Now has basic support for multi-line input in interactive mode. (#34822)
If an entered line contains opening parentheses/etc that are not closed, Terraform will await another line of input to complete the expression. This initial implementation is primarily intended to support pasting in multi-line expressions from elsewhere, rather than for manual multi-line editing, so the interactive editing support is currently limited.removed
blocks can now declare destroy-time provisioners which will be executed when the associated resource instances are destroyed. (#35230)BUG FIXES:
remote-exec
provisioner: Each remote connection will now be closed immediately after use. (#34137)terraform test
: Fix bug in which non-Hashicorp providers required by testing modules and initialised within the test files were assigned incorrect registry addresses. (#35161)templatefile
function no longer returns a "panic" error if the template file path is marked as sensitive. Instead, the template rendering result is also marked as sensitive. (#35180)terraform init
: When selecting a version for a provider that has both positive and negative version constraints for the same prerelease -- e.g. 1.2.0-beta.1, !1.2.0-beta.1
-- the negative constraint will now overrule the positive, for consistency with how negative constraints are handled otherwise. Previously Terraform would incorrectly treat the positive as overriding the negative if the specified version was a prerelease. (#35181)UPGRADE NOTES:
terraform test
: It is no longer valid to specify version constraints within provider blocks within .tftest.hcl files. Instead, version constraints must be supplied within the main configuration where the provider is in use.For information on prior major and minor releases, see their changelogs:
BUG FIXES:
core
: Fix exponential slowdown in some cases when modules are using depends_on
. (#35157)import
blocks: Fix bug where resources with nested, computed, and optional id
attributes would fail to generate configuration. (#35220)golang.org/x/net
release, which addressed CVE-2023-45288 (#35165)ENHANCEMENTS:
terraform console
: Now has basic support for multi-line input in interactive mode. (#34822)
If an entered line contains opening parentheses/etc that are not closed, Terraform will await another line of input to complete the expression. This initial implementation is primarily intended to support pasting in multi-line expressions from elsewhere, rather than for manual multi-line editing, so the interactive editing support is currently limited.
terraform plan
: Improved presentation of OPA and Sentinel policy evaluations in HCP Terraform remote runs, for logical separation.
terraform init
now accepts a -json
option. If specified, enables the machine readable JSON output. (#34886)
terraform test
: Test runs can now pass sensitive values to input variables while preserving their dynamic sensitivity. Previously sensitivity would be preserved only for variables statically declared as being sensitive, using sensitive = true
. (#35021)
Performance improvement during graph building for configurations with an extremely large number of resource
blocks. (#35088)
BUG FIXES:
remote-exec
: Each remote connection will now be closed immediately after use. (#34137)backend/s3
: Fixed the digest value displayed for DynamoDB/S3 state checksum mismatches. (#34387)terraform test
: Fix bug in which non-Hashicorp providers required by testing modules and initialised within the test files were assigned incorrect registry addresses. (#35161)UPGRADE NOTES:
terraform test
: It is no longer valid to specify version constraints within provider blocks within .tftest.hcl files. Instead, version constraints must be supplied within the main configuration where the provider is in use.EXPERIMENTS:
Experiments are only enabled in alpha releases of Terraform CLI. The following features are not yet available in stable releases.
variable_validation_crossref
: This language experiment allows validation
blocks inside input variable declarations to refer to other objects inside the module where the variable is declared, including to the values of other input variables in the same module.template_string_func
: This language experiment introduces a new built-in function named templatestring
which is similar to templatefile
but designed to render templates obtained dynamically, such as from a data resource result.terraform test
accepts a new option -junit-xml=FILENAME
. If specified, and if the test configuration is valid enough to begin executing, then Terraform writes a JUnit XML test result report to the given filename, describing similar information as included in the normal test output. (#34291)terraform rpcapi
exposes some Terraform Core functionality through an RPC interface compatible with go-plugin
. The exact RPC API exposed here is currently subject to change at any time, because it's here primarily as a vehicle to support the Terraform Stacks private preview and so will be broken if necessary to respond to feedback from private preview participants, or possibly for other reasons. Do not use this mechanism yet outside of Terraform Stacks private preview.-allow-deferral
option to terraform plan
, permits count
and for_each
arguments in module
, resource
, and data
blocks to have unknown values and allows providers to react more flexibly to unknown values. This experiment is under active development, and so it's not yet useful to participate in this experiment.For information on prior major and minor releases, see their changelogs: