Terraform - Infrastructure as Code
Find a file
Sarah French fd7f25120b
Some checks are pending
build / Determine intended Terraform version (push) Waiting to run
build / Determine Go toolchain version (push) Waiting to run
build / Generate release metadata (push) Blocked by required conditions
build / Build for freebsd_386 (push) Blocked by required conditions
build / Build for linux_386 (push) Blocked by required conditions
build / Build for openbsd_386 (push) Blocked by required conditions
build / Build for windows_386 (push) Blocked by required conditions
build / Build for darwin_amd64 (push) Blocked by required conditions
build / Build for freebsd_amd64 (push) Blocked by required conditions
build / Build for linux_amd64 (push) Blocked by required conditions
build / Build for openbsd_amd64 (push) Blocked by required conditions
build / Build for solaris_amd64 (push) Blocked by required conditions
build / Build for windows_amd64 (push) Blocked by required conditions
build / Build for freebsd_arm (push) Blocked by required conditions
build / Build for linux_arm (push) Blocked by required conditions
build / Build for darwin_arm64 (push) Blocked by required conditions
build / Build for linux_arm64 (push) Blocked by required conditions
build / Build for windows_arm64 (push) Blocked by required conditions
build / Build Docker image for linux_386 (push) Blocked by required conditions
build / Build Docker image for linux_amd64 (push) Blocked by required conditions
build / Build Docker image for linux_arm (push) Blocked by required conditions
build / Build Docker image for linux_arm64 (push) Blocked by required conditions
build / Build e2etest for linux_386 (push) Blocked by required conditions
build / Build e2etest for windows_386 (push) Blocked by required conditions
build / Build e2etest for darwin_amd64 (push) Blocked by required conditions
build / Build e2etest for linux_amd64 (push) Blocked by required conditions
build / Build e2etest for windows_amd64 (push) Blocked by required conditions
build / Build e2etest for linux_arm (push) Blocked by required conditions
build / Build e2etest for darwin_arm64 (push) Blocked by required conditions
build / Build e2etest for linux_arm64 (push) Blocked by required conditions
build / Run e2e test for linux_386 (push) Blocked by required conditions
build / Run e2e test for windows_386 (push) Blocked by required conditions
build / Run e2e test for darwin_amd64 (push) Blocked by required conditions
build / Run e2e test for linux_amd64 (push) Blocked by required conditions
build / Run e2e test for windows_amd64 (push) Blocked by required conditions
build / Run e2e test for linux_arm (push) Blocked by required conditions
build / Run e2e test for linux_arm64 (push) Blocked by required conditions
build / Run terraform-exec test for linux amd64 (push) Blocked by required conditions
Quick Checks / Unit Tests (push) Waiting to run
Quick Checks / Race Tests (push) Waiting to run
Quick Checks / End-to-end Tests (push) Waiting to run
Quick Checks / Code Consistency Checks (push) Waiting to run
PSS: Allow pluggable state store configuration to be read from a plan file (#37957)
* feat: Allow reading state store configuration from a planfile and using it to prepare a Local backend that uses the state store

* test: Assert that we can get and use state store configuration from a plan file

* test: Add integration test showing that an apply command can use a plan file to configure and use a state store

* test: Add E2E test showing pluggable state storage being used with the full init-plan-apply workflow

* feat: A plan file will report the state storage provider among its required providers, if PSS is in use.

See the code comment added in this commit. This addition does not impact an apply command as the missing provider will be detected before this code is executed. However I'm making this change so that the method is still accurate is being able to return a complete list of providers needed by the plan.

* fix: Include error messages when there is a problem parsing provider or state store config when getting a backend from a planfile

* feat: Add trace logs to BackendForLocalPlan indicating when the provider is launched and the state store is configured

* chore: Small grammar change in error diagnostic

* refactor: Remove suggestions when the plan's state store doesn't match the implementations in the provider

* test: Add test coverage of what happens when the contents of a plan file using PSS doesn't match the resources available in the project
2025-12-18 11:49:31 +00:00
.changes fix: validate replace_triggered_by attribute references (#38010) 2025-12-17 19:50:51 +00:00
.github build(deps): bump actions/checkout in the github-actions-breaking group (#37951) 2025-12-01 18:09:12 +00:00
.release PSP-3163: update scan config to enable osv (#37817) 2025-10-28 10:17:23 +00:00
docs Implement LockState & UnlockState provider methods (#37711) 2025-10-03 10:02:02 +01:00
internal PSS: Allow pluggable state store configuration to be read from a plan file (#37957) 2025-12-18 11:49:31 +00:00
scripts add date 2025-07-16 12:14:48 +02:00
testing/equivalence-tests Update equivalence test golden files. 2025-11-10 20:42:21 +00:00
tools Upgrade protoc and protoc-gen-go-grpc versions to matching terraform-plugin-go (#37647) 2025-10-22 14:46:18 +01:00
version Cleanup after 1.15.0-alpha20251203 release (#38002) 2025-12-15 18:10:57 +00:00
website website: (Re)Move markdown documentation (#37417) 2025-08-11 11:25:18 +02:00
.changie.yaml Prepare main branch for post-v1.14 development (#37621) 2025-09-16 18:16:30 +01:00
.copywrite.hcl make changie dirs excempt from copyright headers 2025-02-18 13:51:23 +01:00
.gitignore test: create all edges to leaf cleanup nodes (#37564) 2025-09-09 11:20:56 +02:00
.go-version go: bump version to 1.25 (#37436) 2025-08-18 12:17:59 +02:00
.tfdev Remove revision from version command 2021-01-12 16:35:30 -05:00
BUGPROCESS.md Update BUGPROCESS.md 2023-03-18 17:14:20 -04:00
build.Dockerfile build.Dockerfile: Install ca-certificates (#36486) 2025-02-12 18:11:50 +00:00
BUILDING.md elaborate further on experiments and cgo 2023-07-17 11:56:13 -07:00
catalog-info.yaml Update owner field in catalog-info.yaml (#36963) 2025-05-05 11:33:38 +02:00
CHANGELOG.md Cleanup after 1.15.0-alpha20251203 release (#38002) 2025-12-15 18:10:57 +00:00
checkpoint.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00
CODEOWNERS Revert "temporarily require manager approval for go.mod changes" (#37694) 2025-09-29 14:58:13 +02:00
commands.go tf query: ready list blocks for beta (#37619) 2025-09-17 12:29:04 +02:00
Dockerfile Dockerfile: Install ca-certificates (#36471) 2025-02-12 10:11:19 +00:00
experiments.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00
go.mod Add component registry source resolution support to Terraform Stacks (#37888) 2025-12-10 09:16:03 -05:00
go.sum Add component registry source resolution support to Terraform Stacks (#37888) 2025-12-10 09:16:03 -05:00
help.go website: (Re)Move markdown documentation (#37417) 2025-08-11 11:25:18 +02:00
LICENSE update year in license files 2023-12-06 11:58:53 -08:00
main.go First step to enable use of TF_REATTACH_PROVIDERS with PSS (#37634) 2025-09-19 11:42:13 +00:00
main_test.go Update test for autocompletion of top-level commands (#37853) 2025-11-05 11:24:29 +00:00
Makefile website: (Re)Move markdown documentation (#37417) 2025-08-11 11:25:18 +02:00
provider_source.go Rebrand Terraform Cloud to HCP Terraform 2024-04-23 16:12:59 -04:00
README.md website: (Re)Move markdown documentation (#37417) 2025-08-11 11:25:18 +02:00
signal_unix.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00
signal_windows.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00
staticcheck.conf chore: Bump golang.org/x/crypto dependency, ignore SA4003 linting errors globally (#37901) 2025-11-17 15:01:28 +00:00
telemetry.go add missing copyright headers 2023-08-16 11:21:49 -07:00
version.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00
working_dir.go Update copyright file headers to BUSL-1.1 2023-08-10 23:43:27 +01:00

Terraform

Terraform

Terraform is a tool for building, changing, and versioning infrastructure safely and efficiently. Terraform can manage existing and popular service providers as well as custom in-house solutions.

The key features of Terraform are:

  • Infrastructure as Code: Infrastructure is described using a high-level configuration syntax. This allows a blueprint of your datacenter to be versioned and treated as you would any other code. Additionally, infrastructure can be shared and re-used.

  • Execution Plans: Terraform has a "planning" step where it generates an execution plan. The execution plan shows what Terraform will do when you call apply. This lets you avoid any surprises when Terraform manipulates infrastructure.

  • Resource Graph: Terraform builds a graph of all your resources, and parallelizes the creation and modification of any non-dependent resources. Because of this, Terraform builds infrastructure as efficiently as possible, and operators get insight into dependencies in their infrastructure.

  • Change Automation: Complex changesets can be applied to your infrastructure with minimal human interaction. With the previously mentioned execution plan and resource graph, you know exactly what Terraform will change and in what order, avoiding many possible human errors.

For more information, refer to the What is Terraform? page on the Terraform website.

Getting Started & Documentation

Documentation is available on the Terraform website:

If you're new to Terraform and want to get started creating infrastructure, please check out our Getting Started guides on HashiCorp's learning platform. There are also additional guides to continue your learning.

Show off your Terraform knowledge by passing a certification exam. Visit the certification page for information about exams and find study materials on HashiCorp's learning platform.

Developing Terraform

This repository contains only Terraform core, which includes the command line interface and the main graph engine. Providers are implemented as plugins, and Terraform can automatically download providers that are published on the Terraform Registry. HashiCorp develops some providers, and others are developed by other organizations. For more information, refer to Plugin development.

License

Business Source License 1.1