Go to file
Kristin Laemmert 60321b41e8
getproviders: move protocol compatibility functions into registry client (#24846)
* internal/registry source: return error if requested provider version protocols are not supported

* getproviders: move responsibility for protocol compatibility checks into the registry client

The original implementation had the providercache checking the provider
metadata for protocol compatibility, but this is only relevant for the
registry source so it made more sense to move the logic into
getproviders.

This also addresses an issue where we were pulling the metadata for
every provider version until we found one that was supported. I've
extended the registry client to unmarshal the protocols in
`ProviderVersions` so we can filter through that list, instead of
pulling each version's metadata.
2020-05-11 13:49:12 -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 getproviders: move protocol compatibility functions into registry client (#24846) 2020-05-11 13:49:12 -04:00
backend Merge pull request #24696 from hashicorp/leetrout/remote-state-force-push 2020-05-06 15:23:28 -04:00
builtin providers/terraform: test that validation does not configure backend 2020-05-07 11:08:10 -07:00
command getproviders: move protocol compatibility functions into registry client (#24846) 2020-05-11 13:49:12 -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 Disallow provider configuration in expanding modules (#24892) 2020-05-08 11:35:28 -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 getproviders: move protocol compatibility functions into registry client (#24846) 2020-05-11 13:49:12 -04:00
lang Merge pull request #24484 from ctjhoa/fix_typo 2020-05-04 16:11:47 -07: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 Add more validation to expanding modules 2020-05-06 09:52:11 -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 vendor: go get github.com/hashicorp/hcl/v2@v2.5.0 2020-05-07 10:35:08 -04:00
version Update version.go 2020-02-19 17:42:33 -05:00
website Merge pull request #24875 from hashicorp/cgriggs01-community 2020-05-08 07:59:46 -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 skip lock comments on issues closed/updated over 60 days 2020-05-04 17:59:03 -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-05-07 11:10:57 -07: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.5.0 2020-05-07 10:35:08 -04:00
go.sum vendor: go get github.com/hashicorp/hcl/v2@v2.5.0 2020-05-07 10:35:08 -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 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