Go to file
Martin Atkins 4d7122a0dd internal/getproviders: LookupLegacyProvider
This is a temporary helper so that we can potentially ship the new
provider installer without making a breaking change by relying on the
old default namespace lookup API on the default registry to find a proper
FQN for a legacy provider provider address during installation.

If it's given a non-legacy provider address then it just returns the given
address verbatim, so any codepath using it will also correctly handle
explicit full provider addresses. This also means it will automatically
self-disable once we stop using addrs.NewLegacyProvider in the config
loader, because there will therefore no longer be any legacy provider
addresses in the config to resolve. (They'll be "default" provider
addresses instead, assumed to be under registry.terraform.io/hashicorp/* )

It's not decided yet whether we will actually introduce the new provider
in a minor release, but even if we don't this API function will likely be
useful for a hypothetical automatic upgrade tool to introduce explicit
full provider addresses into existing modules that currently rely on
the equivalent to this lookup in the current provider installer.

This is dead code for now, but my intent is that it would either be called
as part of new provider installation to produce an address suitable to
pass to Source.AvailableVersions, or it would be called from the
aforementioned hypothetical upgrade tool.

Whatever happens, these functions can be removed no later than one whole
major release after the new provider installer is introduced, when
everyone's had the opportunity to update their legacy unqualified
addresses.
2020-01-22 09:02:22 -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 #23293 from kmfk/hide-values-undeclared-var-warning 2020-01-15 16:08:19 -08:00
builtin providers: use addrs.Provider as map keys for provider.Factory (#23548) 2019-12-04 11:30:20 -05:00
command command/show: fix issue with show and aliased provider (#23848) 2020-01-13 15:10:00 -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 allow "terraform" in destroy provisioners 2020-01-15 11:39:01 -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 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 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: LookupLegacyProvider 2020-01-22 09:02:22 -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 configs: extend module.ProviderRequirements to include the addrs.Provider instead of just version constraints. (#23843) 2020-01-13 11:31:47 -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 Merge pull request #23923 from hashicorp/cgriggs01-stable-metal 2020-01-22 08:54:06 -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 Update CHANGELOG.md 2020-01-14 08:30:41 -05: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 Remove config.go and update things using its aliases 2020-01-13 16:50:05 -05:00
commands.go Remove config.go and update things using its aliases 2020-01-13 16:50:05 -05: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 Remove config.go and update things using its aliases 2020-01-13 16:50:05 -05: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
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