Go to file
Lee Trout cb0e20ca2b Add support for force pushing with the remote backend
Both differing serials and lineage protections should be bypassed
with the -force flag (in addition to resources).

Compared to other backends we aren’t just shipping over the state
bytes in a simple payload during the persistence phase of the push
command and the force flag added to the Go TFE client needs to be
specified at that time.

To prevent changing every method signature of PersistState of the
remote client I added an optional interface that provides a hook
to flag the Client as operating in a force push context. Changing
the method signature would be more explicit at the cost of not
being used anywhere else currently or the optional interface pattern
could be applied to the state itself so it could be upgraded to
support PersistState(force bool) only when needed.

Prior to this only the resources of the state were checked for
changes not the lineage or the serial. To bring this in line with
documented behavior noted above those attributes also have a “read”
counterpart just like state has. These are now checked along with
state to determine if the state as a whole is unchanged.

Tests were altered to table driven test format and testing was
expanded to include WriteStateForMigration and its interaction
with a ClientForcePusher type.
2020-05-06 12:07:43 -04:00
.circleci Only notify Slack on job failure 2020-04-22 11:26:44 -04:00
.github Fix typo in CONTRIBUTING.md 2020-04-13 18:01:12 -07:00
addrs Merge pull request #24697 from hashicorp/jbardin/get-module-data 2020-04-22 09:49:45 -04:00
backend Add support for force pushing with the remote backend 2020-05-06 12:07:43 -04:00
builtin Merge pull request #24321 from davidMcneil/master 2020-03-27 11:29:38 -04:00
command Merge pull request #24807 from hashicorp/jbardin/remove-each-mode 2020-05-03 10:54:07 -04:00
communicator ssh: Fix deadlock on agent forwarding error 2019-12-12 18:16:17 +01:00
config Move the commit along with 2020-03-02 15:56:38 -05:00
configs configs: Fix for resources with implied providers 2020-04-28 14:54:31 -04:00
contrib contrib: Remove api-coverage tool 2019-10-18 11:22:30 -07:00
dag remove excess logging from dag 2020-04-08 12:30:35 -04:00
digraph Fix TestWriteDot random order error 2014-07-29 10:26:50 -07:00
docs docs: Fix typo in maintainer-etiquette (#24609) 2020-04-10 08:55:19 -04: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 config: Allow module authors to specify validation rules for variables 2020-01-10 15:23:25 -08:00
flatmap prune references to config/module 2019-08-07 17:50:59 -04:00
helper Fix typos (#24531) 2020-04-13 08:34:40 -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 providercache: actually break out of the loop when a matching version is found (#24823) 2020-05-01 08:49:47 -04:00
lang Merge pull request #24697 from hashicorp/jbardin/get-module-data 2020-04-22 09:49:45 -04:00
moduledeps rename provider-specific functions (#24417) 2020-03-20 13:59:59 -04:00
plans plans fix 2020-04-13 16:21:09 -04:00
plugin Add support for provider metadata to modules. (#22583) 2020-03-05 16:53:24 -08: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 remove travis script file 2020-04-06 10:49:28 -04:00
state Add support for force pushing with the remote backend 2020-05-06 12:07:43 -04:00
states remove a few traces of states.EachMode 2020-04-30 09:22:15 -04:00
terraform 2 more tests that weren't correct 2020-04-30 09:22:14 -04:00
tfdiags tfdiags: Diagnostics.ToHCL 2020-03-12 11:11:29 -07:00
tools tools/terraform-bundle: refactor to use new provider installer and provider directory layouts (#24629) 2020-04-21 17:09:29 -04:00
vendor Update dependencies 2020-04-25 08:41:54 +02:00
version Update version.go 2020-02-19 17:42:33 -05:00
website Add reference to new modules track (#24445) 2020-04-28 11:09:42 -07:00
.gitignore Coverage 2020-03-03 13:01:05 -05:00
.go-version build: Use Go 1.14 2020-03-04 13:26:50 -08:00
.hashibot.hcl apply special label for PRs affecting sdk paths 2019-09-06 15:22:43 -04:00
.tfdev .tfdev: remove platform build constraint 2019-08-09 15:10:52 -07:00
BUILDING.md Edit BUILDING.md 2019-11-17 15:04:22 -08:00
CHANGELOG.md Update CHANGELOG.md 2020-04-28 12:27:10 -04:00
CODEOWNERS Change my username. 2020-04-18 08:34:22 +01: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 Coverage updates, roll back makefile change, use travis specific script 2020-03-03 14:10:17 -05: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: Add state replace-provider subcommand 2020-04-02 08:15:52 -04:00
go.mod Update dependencies 2020-04-25 08:41:54 +02:00
go.sum Update dependencies 2020-04-25 08:41:54 +02:00
help.go help: Make version and help flags consistent 2018-08-01 14:28:39 -07:00
main.go fixup main.go comment about providersource 2020-04-23 10:52:01 -07: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 main: Properly handle provider installation method exclusions 2020-04-23 10:52:01 -07: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