Go to file
Martin Atkins 08ba58c8c8 website: Documentation about the one-to-one object binding assumption
Terraform's design assumes that each remote object in Terraform's care is
bound to one resource instance and one alone. If the same object is bound
to multiple instances then confusing behavior will often result, such as
two resource configurations competing to update a single object, or
objects being "left behind" when all existing Terraform deployments are
destroyed.

This assumption was previously only implied, though. This change is an
attempt to be more explicit about it, although these are additions to some
older documentation sections that have not been revised for some time and
so this is just a best effort to make this information discoverable
without getting drawn into a full-on reorganization of these sections.

While revising this there were some particular oddities that I decided to
revise while I was there, but I'll leave a fuller revision of this older
content for a later commit when we have more time to review it in greater
detail.
2020-07-31 15:22:50 -07:00
.circleci add test for 'full' docker image build 2020-06-17 10:48:10 -04:00
.github fix .go-version repo link 2020-07-23 20:22:53 -07:00
addrs addrs: Disallow provider source addresses starting with terraform- 2020-07-08 10:18:55 -07:00
backend Revert "backend/local: release lock if there is an error in Context() (#25427)" 2020-06-30 14:12:32 -04:00
builtin always return original workspace, even when null 2020-06-24 13:41:51 -04:00
command command/show: fix bug displaying provider config in json output of tf plan (#25577) 2020-07-14 15:28:31 -04:00
communicator communicator/winrm: include configured timeout in winrm server 2020-06-25 08:41:09 -04:00
config Move the commit along with 2020-03-02 15:56:38 -05:00
configs configs: prevent panic with invalid type name (#25562) 2020-07-13 09:47:16 -04:00
contrib contrib: Remove api-coverage tool 2019-10-18 11:22:30 -07:00
dag quote dot node names 2020-06-15 13:28:53 -04:00
digraph Fix TestWriteDot random order error 2014-07-29 10:26:50 -07:00
docs Fix spelling mistakes/typos in documentation 2020-07-22 18:24:32 +02:00
e2e tools/terraform-bundle: refactor to use new provider installer and provider directory layouts (#24629) 2020-04-21 17:09:29 -04:00
examples Fix Google Cloud Platform name across docs. 2019-01-15 12:10:20 -08:00
experiments configs: Custom variable validation is no longer experimental 2020-05-28 16:07:59 -07:00
flatmap prune references to config/module 2019-08-07 17:50:59 -04:00
helper remove depends_on from helper test shims 2020-05-14 15:57:16 -04:00
httpclient Merge pull request #22272 from hashicorp/f-httpclient-ua 2019-08-12 20:20:03 +01:00
instances Expander.ExpandResource cannot expand all modules 2020-03-25 11:58:23 -04:00
internal internal/providercache: Fix bug when symlink fails 2020-07-23 11:36:46 -04:00
lang lang/funcs: Filesystem functions hint about dynamically-generated files 2020-06-24 09:02:38 -07:00
moduledeps rename provider-specific functions (#24417) 2020-03-20 13:59:59 -04:00
plans plans: Update error message for apply validation (#21312) 2020-06-05 15:08:10 -04:00
plugin plugin/discovery: Remove dead code 2020-05-28 15:20:41 -04:00
providers Remove terraform.ResourceProvider, use providercache.Installer instead 2020-04-06 09:24:23 -07:00
provisioners provisioners: Add Factory type and FactoryFixed helper 2018-10-16 19:14:11 -07:00
registry registry: Fix panic when server is unreachable 2020-03-19 10:20:10 -04:00
repl fix error output in repl test 2020-04-14 14:50:43 -04:00
scripts use alpine:latest as the base image for terraform docker containers 2020-07-01 16:03:06 -04:00
state Add support for force pushing with the remote backend 2020-05-06 12:07:43 -04:00
states addrs: detect builtin provider when parsing legacy provider string (#25154) 2020-06-08 08:27:36 -04:00
terraform destroy provisioner test 2020-07-20 15:49:51 -04:00
tfdiags tfdiags: Diagnostics.ToHCL 2020-03-12 11:11:29 -07:00
tools Syntax updates 2020-07-22 11:05:33 -04:00
vendor go get github.com/zclconf/go-cty@v1.5.1 2020-06-25 17:05:19 -04:00
version Cleanup after v0.13.0-rc1 release 2020-07-22 14:21:10 +00:00
website website: Documentation about the one-to-one object binding assumption 2020-07-31 15:22:50 -07:00
.gitignore Coverage 2020-03-03 13:01:05 -05:00
.go-version Update azure backend storage sdk (#24669) 2020-05-20 17:29:02 +02:00
.hashibot.hcl Remove hashibot panic issue labeler 2020-05-13 11:58:57 -07:00
.tfdev .tfdev: remove platform build constraint 2019-08-09 15:10:52 -07:00
CHANGELOG.md Update CHANGELOG.md 2020-07-31 14:16:53 -07:00
CODEOWNERS Add kubernetes backend 2020-06-04 02:29:57 -04:00
Dockerfile build: Don't create apk cache in "full" docker image 2019-11-11 16:04:23 -08:00
LICENSE Adding license 2014-07-28 13:54:06 -04:00
Makefile Makefile: remove unused targets 2020-06-08 07:02:54 -04:00
README.md Added links to Learn and certification exams to the README 2020-03-27 11:25:06 -07:00
checkpoint.go Remove config.go and update things using its aliases 2020-01-13 16:50:05 -05:00
codecov.yml Set Codecov threshold to 0.05% to avoid flicker 2020-03-09 14:56:30 -04:00
commands.go command: terraform providers mirror 2020-06-01 14:49:43 -07:00
go.mod go get github.com/zclconf/go-cty@v1.5.1 2020-06-25 17:05:19 -04:00
go.sum go get github.com/zclconf/go-cty@v1.5.1 2020-06-25 17:05:19 -04:00
help.go help: Make version and help flags consistent 2018-08-01 14:28:39 -07:00
main.go main: Pass untyped nil for missing creds source 2020-06-03 09:46:53 -04:00
main_test.go main: make configuration available when initializing commands 2017-09-29 14:03:09 -07:00
panic.go main: Warn about potential sensitive information in logs when panicking 2019-11-06 14:12:33 -08:00
plugins.go Remove config.go and update things using its aliases 2020-01-13 16:50:05 -05:00
provider_source.go init: fix issue loading local plugin directory 2020-06-11 11:30:44 -04:00
signal_unix.go Forward SIGTERM and handle that as an interrupt 2016-12-08 12:20:25 -05:00
signal_windows.go Forward SIGTERM and handle that as an interrupt 2016-12-08 12:20:25 -05:00
synchronized_writers.go main: synchronize writes to VT100-faker on Windows 2017-05-04 15:36:51 -07:00
version.go states/statemgr: Fix the Filesystem state manager tests 2018-11-19 09:02:35 -08:00

README.md

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, see the introduction section of 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 that each have their own repository in the terraform-providers organization on GitHub. Instructions for developing each provider are in the associated README file. For more information, see the provider development overview.

To learn more about compiling Terraform and contributing suggested changes, please refer to the contributing guide.

License

Mozilla Public License v2.0