Go to file
Martin Atkins 02576988c1 lang: "try" and "can" functions
These are intended to make it easier to work with arbitrary data
structures whose shape might not be known statically, such as the result
of jsondecode(...) or yamldecode(...) of data from a separate system.

For example, in an object value which has attributes that may or may not
be set we can concisely provide a fallback value to use when the attribute
isn't set:

    try(local.example.foo, "fallback-foo")

Using a "try to evaluate" model rather than explicit testing fits better
with the usual programming model of the Terraform language where values
are normally automatically converted to the necessary type where possible:
the given expression is subject to all of the same normal type conversions,
which avoids inadvertently creating a more restrictive evaluation model
as might happen if this were handled using checks like a hypothetical
isobject(...) function, etc.
2020-01-10 15:23:25 -08:00
.github Update .github/SECURITY.md 2019-12-02 13:07:02 +00:00
addrs addrs: Fix infinite recursion in AbsInputVariableInstance.String 2020-01-10 15:23:25 -08:00
backend Merge pull request #23656 from hashicorp/paddy_gcs_backend_env_var 2019-12-17 07:30:41 -05:00
builtin providers: use addrs.Provider as map keys for provider.Factory (#23548) 2019-12-04 11:30:20 -05:00
command Mildwonkey/tfconfig upgrade (#23670) 2020-01-10 11:54:53 -05:00
communicator ssh: Fix deadlock on agent forwarding error 2019-12-12 18:16:17 +01:00
config config: Remove legacy interpolation function implementations 2019-10-29 08:25:45 -07:00
configs Mildwonkey/tfconfig upgrade (#23670) 2020-01-10 11:54:53 -05:00
contrib contrib: Remove api-coverage tool 2019-10-18 11:22:30 -07:00
dag Correct simple typo in `walk.go`. 2019-10-22 11:40:50 +02:00
digraph Fix TestWriteDot random order error 2014-07-29 10:26:50 -07:00
docs vendor: switch to HCL 2.0 in the HCL repository 2019-10-02 15:10:21 -07: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 experiments: a mechanism for opt-in experimental language features 2019-12-10 09:27:05 -08:00
flatmap prune references to config/module 2019-08-07 17:50:59 -04:00
helper addrs: replace "Type string" with "Type Provider" in ProviderConfig 2019-12-06 08:00:18 -05:00
httpclient Merge pull request #22272 from hashicorp/f-httpclient-ua 2019-08-12 20:20:03 +01:00
internal internal/getproviders: Distinguished packed vs. unpacked local packages 2020-01-10 09:41:27 -08:00
lang lang: "try" and "can" functions 2020-01-10 15:23:25 -08:00
moduledeps plugin/discovery: PluginRequirements can specify SHA256 digests 2017-06-09 14:03:59 -07:00
plans addrs: replace "Type string" with "Type Provider" in ProviderConfig 2019-12-06 08:00:18 -05:00
plugin Mildwonkey/tfconfig upgrade (#23670) 2020-01-10 11:54:53 -05:00
providers addrs: replace "Type string" with "Type Provider" in ProviderConfig 2019-12-06 08:00:18 -05:00
provisioners provisioners: Add Factory type and FactoryFixed helper 2018-10-16 19:14:11 -07:00
registry Replace import paths & set UA string where necessary 2019-10-11 22:40:54 +01:00
repl addrs: replace "Type string" with "Type Provider" in ProviderConfig 2019-12-06 08:00:18 -05:00
scripts make: Add check for protobuf dependencies 2019-09-05 14:30:54 +02:00
state Merge pull request #20571 from sergkondr/fix_misspelling 2019-08-13 17:13:13 -04:00
states configs: move ProviderConfigCompact[Str] from addrs to configs 2019-12-09 08:30:08 -05:00
terraform Add GraphNodeNoProvider to skip adding a providers 2020-01-10 16:28:44 -05:00
tfdiags command: New -compact-warnings option 2019-12-10 11:53:14 -08:00
tools terraform-bundle: fix panic with addrs.Provider 2019-12-12 09:14:38 -05:00
vendor lang: "try" and "can" functions 2020-01-10 15:23:25 -08:00
version Cleanup after v0.12.19 release 2020-01-08 22:55:24 +00:00
website lang: "try" and "can" functions 2020-01-10 15:23:25 -08:00
.gitignore Standardise directory name for test data 2019-06-30 10:16:15 +02:00
.go-version Build with Go 1.12.13 2019-11-06 07:02:54 -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
.travis.yml Build with Go 1.12.13 2019-11-06 07:02:54 -08:00
BUILDING.md Edit BUILDING.md 2019-11-17 15:04:22 -08:00
CHANGELOG.md Cleanup after v0.12.19 release 2020-01-08 22:55:24 +00:00
CODEOWNERS First pass at adding CODEOWNERS to link remote-state backends with maintainers of the associated providers. 2019-02-11 15:52:19 -08: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 build: add terraform-bundle e2etests 2019-12-12 09:26:26 -05:00
README.md Revise our contributing/development documentation 2019-10-15 08:39:36 -07:00
checkpoint.go fixing version numbers RCs should be labeled x.x.x-rcx 2015-02-07 16:56:56 +01:00
commands.go Replace import paths & set UA string where necessary 2019-10-11 22:40:54 +01:00
config.go command/cliconfig: Factor out CLI config handling 2019-08-01 10:56:41 -07:00
go.mod vendor: go get github.com/hashicorp/hcl/v2@v2.3.0 2020-01-10 15:23:25 -08:00
go.sum vendor: go get github.com/hashicorp/hcl/v2@v2.3.0 2020-01-10 15:23:25 -08:00
help.go help: Make version and help flags consistent 2018-08-01 14:28:39 -07:00
main.go Replace import paths & set UA string where necessary 2019-10-11 22:40:54 +01: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 keep .terraform.d/plugins for discovery 2017-08-09 17:46:49 -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

If you're new to Terraform and want to get started creating infrastructure, please checkout our Getting Started guide, available on the Terraform website.

All documentation is available on the Terraform website:

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