State stores

Tip

State store support in framework is currently experimental and offered without compatibility promises until Terraform core support for state stores is generally available.

State store support can be enabled in Terraform v1.15+ alpha releases by running Terraform commands with the -enable-pluggable-state-storage-experiment flag or setting the environment variable TF_ENABLE_PLUGGABLE_STATE_STORAGE to any value.

State stores are an abstraction that allow Terraform to persist its state data files in remote objects. State stores replace the existing backend concept, which are built directly into Terraform, with provider-defined logic.

Implementation

Learn about how to implement code for a state store in the framework.

Testing

Learn about how to ensure a state store implementation works as expected via acceptance testing.