Go to file
Kristin Laemmert a43f141f9e
tools/terraform-bundle: refactor to use new provider installer and provider directory layouts (#24629)
* tools/terraform-bundle: refactor to use new provider installer and
provider directory layouts

terraform-bundle now supports a "source" attribute for providers,
uses the new provider installer, and the archive it creates preserves
the new (required) directory hierarchy for providers, under a "plugins"
directory.

This is a breaking change in many ways: source is required for any
non-HashiCorp provider, locally-installed providers must be given a
source (can be arbitrary, see docs) and placed in the expected directory
hierarchy, and the unzipped archive is no longer flat; there is a new
"plugins" directory created with providers in the new directory layout.

This PR also extends the existing test to check the contents of the zip
file.

TODO: Re-enable e2e tests (currently suppressed with a t.Skip)
This commit includes an update to our travis configuration, so the terraform-bundle e2e tests run. It also turns off the e2e tests, which will fail until we have a terraform 0.13.* release under releases.hashicorp.com. We decided it was better to merge this now instead of waiting when we started seeing issues opened from users who built terraform-bundle from 0.13 and found it didn't work with 0.12 - better that they get an immediate error message from the binary directing them to build from the appropriate release.
2020-04-21 17:09:29 -04:00
.circleci tools/terraform-bundle: refactor to use new provider installer and provider directory layouts (#24629) 2020-04-21 17:09:29 -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 terraform: return `initialization required` error when provider schemas not found (#24715) 2020-04-21 16:29:27 -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 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 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 tools/terraform-bundle: refactor to use new provider installer and provider directory layouts (#24629) 2020-04-21 17:09:29 -04: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 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.4.0 2020-04-13 10:48:29 -04:00
version Update version.go 2020-02-19 17:42:33 -05:00
website Merge pull request #24533 from raphink/patch-1 2020-04-21 17:04:25 -04: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 main: Consult local directories as potential mirrors of providers 2020-04-06 09:24:23 -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: skip direct provider installation for providers available locally 2020-04-17 13:55:11 -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