1.8.0-alpha20240228 (February 28, 2024)
UPGRADE NOTES:
- The first plan after upgrading may show resource updates with no apparent changes if
-refresh-only
or-refresh=false
is used. The fix introduced for #34567 may require rewriting the state for some resources, which will be done automatically during the first normal plan and apply operation.
NEW FEATURES:
- Providers can now implement functions which can be used from within the Terraform configuration language. The syntax for calling a provider supplied function is
provider::provider_name::function_name()
. (#34394) - Providers can now implement move operations between resource types, both from resource types defined by the provider and defined by other providers. Check provider documentation for supported cross-resource-type moves.
issensitive
function added to detect if a value is marked as sensitive
ENHANCEMENTS:
-
terraform show
's JSON rendering of a plan now includes two explicit flags"applyable"
and"complete"
, which both summarize characteristics of a plan that were previously only inferrable by consumers replicating some of Terraform Core's own logic. (#34642)"applyable"
means that it makes sense for a wrapping automation to offer to apply this plan."complete"
means that applying this plan is expected to achieve convergence between desired and actual state. If this flag is present and set tofalse
then wrapping automations should ideally encourage an operator to run another plan/apply round to continue making progress toward convergence. -
Improved plan diff rendering for lists to display item-level differences on lists with unchanged length.
-
terraform provider lock
accepts a new boolean option-enable-plugin-cache
. If specified, and if a global plugin cache is configured Terraform will use the cache in the provider lock process. (#34632) -
terraform test
: File-level variables can now reference global variables. (#34699) -
In import-generated code represent JSON values in HCL instead of as strings
-
built-in "terraform" provider: new
tfvarsdecode
,tfvarsencode
, andexprencode
functions, for unusual situations where it's helpful to manually generate or read from Terraform's "tfvars" format. (#34718)
BUG FIXES:
- core: Sensitive values will now be tracked more accurately in state and plans, preventing unexpected updates with no apparent changes (#34567)
- cloud: Fixed unparsed color codes in policy failure error messages #34473
EXPERIMENTS:
Experiments are only enabled in alpha releases of Terraform CLI. The following features are not yet available in stable releases.
-
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) -
The new command
terraform rpcapi
exposes some Terraform Core functionality through an RPC interface compatible withgo-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. -
The language-level experiment
unknown_instances
permitscount
andfor_each
arguments inmodule
,resource
, anddata
blocks to have unknown values.This is at an early stage and so currently setting these arguments to unknown values will only yield broken behavior, and so it's not yet useful to participate in this experiment. Future work will improve support for this new possibility, gradually making this experiment viable.
Previous Releases
For information on prior major and minor releases, see their changelogs: