Go to file
Martin Atkins c7fe6b9160 command/cliconfig: handle provider_installation block in JSON syntax
The CLI config can be written in both native HCL and HCL JSON syntaxes, so
the provider_installation block must be expressible using JSON too. Our
previous checks to approximate HCL 2-level strictness were too strict for
HCL JSON where things are more ambiguous even in HCL 2, so this includes
some additional relaxations if we detect that we're decoding an AST
produced from a JSON file.

This is still subject to the quirky ways HCL 1 handles JSON though, so
the JSON value must be structured in a way that doesn't trigger HCL's
heuristics that try to guess what is a block and what is an attribute.
(This is the issue that HCL 2 fixes by always decoding using a schema;
there's more context on this in:
  https://log.martinatkins.me/2019/04/25/hcl-json/ )
2020-04-23 10:52:01 -07:00
.circleci add better error message when 'make fmtcheck generate' fails 2020-04-06 10:52:31 -04:00
.github Fix typo in CONTRIBUTING.md 2020-04-13 18:01:12 -07:00
addrs provider source tests: added test suite to exercise hyphenated providers (#24685) 2020-04-16 15:54:33 -04:00
backend backend/remote: move reading policy check logs earlier 2020-04-15 12:31:44 -07:00
builtin Merge pull request #24321 from davidMcneil/master 2020-03-27 11:29:38 -04:00
command command/cliconfig: handle provider_installation block in JSON syntax 2020-04-23 10:52:01 -07: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 command/providers: refactor with new provider types and functions 2020-04-10 15:08:10 -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 Standardise directory name for test data 2019-06-30 10:16:15 +02: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 command/cliconfig: Use existing HTTP mirror source rather than new stub 2020-04-23 10:52:01 -07:00
lang Feature: Sum Function (#24666) 2020-04-15 14:27:06 -04:00
moduledeps rename provider-specific functions (#24417) 2020-03-20 13:59:59 -04:00
plans finish provider ModuleInstance replacement 2020-03-11 14:19:52 -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 Mildwonkey/tests (#24548) 2020-04-06 09:24:23 -07:00
scripts remove travis script file 2020-04-06 10:49:28 -04:00
state state: update local unlock err (#24320) 2020-03-17 14:01:51 -04:00
states Fix typos (#24531) 2020-04-13 08:34:40 -04:00
terraform terraform: return `initialization required` error when provider schemas not found (#24715) 2020-04-21 16:29:27 -04:00
tfdiags tfdiags: Diagnostics.ToHCL 2020-03-12 11:11:29 -07:00
tools terraform-bundle: fix panic with addrs.Provider 2019-12-12 09:14:38 -05:00
vendor vendor: go get github.com/hashicorp/hcl/v2@v2.4.0 2020-04-13 10:48:29 -04:00
version Update version.go 2020-02-19 17:42:33 -05:00
website [Website] Adding provider docs 2020-04-21 09:11:14 -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-20 12:13:36 -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 vendor: go get github.com/hashicorp/hcl/v2@v2.4.0 2020-04-13 10:48:29 -04:00
go.sum vendor: go get github.com/hashicorp/hcl/v2@v2.4.0 2020-04-13 10:48:29 -04: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 command/cliconfig: Installation methods, not installation sources 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