159 Commits (bc769aeb7ccad4d20e804cb773fcede5260331e3)

Author	SHA1	Message	Date
Martin Atkins	30204ecded	command/cliconfig: Allow development overrides for providers ... For normal provider installation we want to associate each provider with a selected version number and find a suitable package for that version that conforms to the official hashes for that release. Those requirements are very onerous for a provider developer currently testing a not-yet-released build, though. To allow for that case this new CLI configuration feature allows overriding specific providers to refer to give local filesystem directories. Any provider overridden in this way is not subject to the usual restrictions about selected versions or checksum conformance, and activating an override won't cause any changes to the selections recorded in the lock file because it's intended to be a temporary setting for one developer only. This is, in a sense, a spiritual successor of an old capability we had to override specific plugins in the CLI configuration file. There were some vestiges of that left in the main package and CLI config package but nothing has actually been honoring them for several versions now and so this commit removes them to avoid confusion with the new mechanism.	6 years ago
James Bardin	ffbdd72196	Merge pull request #26487 from hashicorp/jbardin/shell-escape ... update taint command example	6 years ago
Pam Selle	8f72f4f317	Merge pull request #21936 from tiny-dancer/patch-1 ... Terraform Plan CLI Vars Format	6 years ago
Pam Selle	305c6fc029	Merge branch 'master' into patch-2	6 years ago
Martin Atkins	897cb72b36	website: Initial docs for the new dependency lock file behaviors ... This includes both the main documentation about the lock file itself and changes to related documentation about Terraform commands that interact with the lock file. We will likely continue to update this first pass of documentation as we get feedback and questions during the prerelease period.	6 years ago
James Bardin	c1efe351b2	update taint command example ... Fix the example to match the usual shell style, and add a note about different shells requiring different escaping formats.	6 years ago
Nick Fagerlund	26f786959b	website: Update all Learn crosslinks (#26442) ... * website: Update all Learn crosslinks The URL structure on Learn recently changed, so it's time to update some URLs. Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>	6 years ago
Jerry Chong	90cbc5a123	Modified terraform force-unlock command ... -Added code block for terraform force-unlock LOCK_ID	6 years ago
Thanonchai	85e83608fc	website: fix broken link to local backend in apply.html (#26307) ... The link to local backend doesn't exist. Update to what I believe is the correct one.	6 years ago
Alisdair McDiarmid	3419422891	website: Fix docs for implied provider FS mirrors ... In addition to the directories previously listed, Terraform looks in the CLI config directory ($HOME/.terraform.d/plugins on macOS/Linux/UNIX, and %APPDATA%/terraform.d/plugins on Windows). List this in the documentation for clarity. We also add a note about the working directory relative "vendor" location, ./terraform.d/plugins.	6 years ago
Matthias Bartelmeß	cec5222287	Correct typo	6 years ago
Martin Atkins	efe78b2910	main: new global option -chdir ... This new option is intended to address the previous inconsistencies where some older subcommands supported partially changing the target directory (where Terraform would use the new directory inconsistently) where newer commands did not support that override at all. Instead, now Terraform will accept a -chdir command at the start of the command line (before the subcommand) and will interpret it as a request to direct all actions that would normally be taken in the current working directory into the target directory instead. This is similar to options offered by some other similar tools, such as the -C option in "make". The new option is only accepted at the start of the command line (before the subcommand) as a way to reflect that it is a global command (not specific to a particular subcommand) and that it takes effect _before_ executing the subcommand. This also means it'll be forced to appear before any other command-specific arguments that take file paths, which hopefully communicates that those other arguments are interpreted relative to the overridden path. As a measure of pragmatism for existing uses, the path.cwd object in the Terraform language will continue to return the _original_ working directory (ignoring -chdir), in case that is important in some exceptional workflows. The path.root object gives the root module directory, which will always match the overriden working directory unless the user simultaneously uses one of the legacy directory override arguments, which is not a pattern we intend to support in the long run. As a first step down the deprecation path, this commit adjusts the documentation to de-emphasize the inconsistent old command line arguments, including specific guidance on what to use instead for the main three workflow commands, but all of those options remain supported in the same way as they were before. In a later commit we'll make those arguments produce a visible deprecation warning in Terraform's output, and then in an even later commit we'll remove them entirely so that -chdir is the single supported way to run Terraform from a directory other than the one containing the root module configuration.	6 years ago
Petros Kolyvas	fa4917172d	Small typo in the internals link to the provider network mirror protocol page (#26098)	6 years ago
Pam Selle	ba461fe0e1	Merge pull request #26004 from bzeitler69/patch-1 ... chore: Update mirror.html.md	6 years ago
Martin Atkins	2bd2a9a923	internal/getproviders: HTTPMirrorSource implementation ... We previously had this just stubbed out because it was a stretch goal for the v0.13.0 release and it ultimately didn't make it in. Here we fill out the existing stub -- with a minor change to its interface so it can access credentials -- with a client implementation that is compatible with the directory structure produced by the "terraform providers mirror" subcommand, were the result to be published on a static file server.	6 years ago
Bogdan Tsaitler	b738da2f04	Update mirror.html.md	6 years ago
Kristin Laemmert	9168abc3e5	website/docs: clarify behavior of -state flag (#25928) ... * website: clarify behavior of -state option	6 years ago
Martin Atkins	08ba58c8c8	website: Documentation about the one-to-one object binding assumption ... Terraform's design assumes that each remote object in Terraform's care is bound to one resource instance and one alone. If the same object is bound to multiple instances then confusing behavior will often result, such as two resource configurations competing to update a single object, or objects being "left behind" when all existing Terraform deployments are destroyed. This assumption was previously only implied, though. This change is an attempt to be more explicit about it, although these are additions to some older documentation sections that have not been revised for some time and so this is just a best effort to make this information discoverable without getting drawn into a full-on reorganization of these sections. While revising this there were some particular oddities that I decided to revise while I was there, but I'll leave a fuller revision of this older content for a later commit when we have more time to review it in greater detail.	6 years ago
Nick Fagerlund	0ab7c1b90e	website: Add links to relevant Learn guides in several docs pages (#25718) ... Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>	6 years ago
Nick Fagerlund	0e5651560b	Website: 0.13 docs edits, mostly around provider requirements (#25686) ... * Make sidebar nav in language docs more intuitive * Minor display fixes for registry docs * Explain providers in the registry in the providers index * Revise a bunch of language docs around provider reqs This is mostly an effort to smooth out some of the explanations, make sure things are presented in a helpful order, make sure terminology lines up, draw connections between related concepts, make default behavior more apparent, and the like. It shouldn't include very much new information, but there might be one or two things that came out of a conversation somewhere. Co-authored-by: Judith Malnick <judith@hashicorp.com>	6 years ago
Shunsuke Suzuki	1dd4d70bab	docs: fix the output format of state show command ... From v0.12 the output format of state show command seems to be changed but the old format is used in the document.	6 years ago
Petros Kolyvas	073fd0d183	Merge pull request #25061 from c-carpenter/patch-1 ... Update taint.html.markdown	6 years ago
Martin Atkins	f1ea705dbe	website: Restore the docs for "terraform 0.12upgrade" ... Although this command is removed in Terraform 0.13, our documentation is for all versions of Terraform that remain in common use and keeping this documented will be helpful for folks who are still using Terraform 0.11 and planning their upgrades to Terraform 0.12. Both of the upgrade commands now include notes that they are only available in their specific major version, along with a link to the relevant upgrade guide for other background information about the upgrade, in case the user finds the command documentation first. (The command docs are, I think, a little more discoverable than the upgrade guides.)	6 years ago
Martin Atkins	49e2e00231	command: terraform providers mirror ... This new command is intended to make it easy to create or update a mirror directory containing suitable providers for the current configuration, producing a layout that is appropriate both for a filesystem mirror or, if copied into the document root of an HTTP server, a network mirror. This initial version is not customizable aside from being able to select multiple platforms to install packages for. Future iterations of this could include commands to turn the JSON index generation on and off, or to instruct it to produce the unpacked directory layout instead of the packed directory layout as it currently does. Both of those options would make the generated directory unsuitable to be a network mirror, but it would still work as a filesystem mirror. In the long run this will hopefully form part of a replacement workflow to terraform-bundle as a way to put copies of providers somewhere so we don't need to re-download them every time, but some other changes will be needed outside of just this command before that'd be true, such as adding support for network and/or filesystem mirrors in Terraform Enterprise.	6 years ago
Martin Atkins	89c2a61b41	website: Small corrections to the "plan" and "apply" command docs ... The "apply" documentation contained a simple typo, while the "plan" documentation contained outdated information about using "terraform plan PLANFILE" to view a plan. The latter is now a separate command entirely, since Terraform 0.12: "terraform show PLANFILE".	6 years ago
Martin Atkins	31a4b44d2e	backend/local: treat output changes as side-effects to be applied ... This is a baby-step towards an intended future where all Terraform actions which have side-effects in either remote objects or the Terraform state can go through the plan+apply workflow. This initial change is focused only on allowing plan+apply for changes to root module output values, so that these can be written into a new state snapshot (for consumption by terraform_remote_state elsewhere) without having to go outside of the primary workflow by running "terraform refresh". This is also better than "terraform refresh" because it gives an opportunity to review the proposed changes before applying them, as we're accustomed to with resource changes. The downside here is that Terraform Core was not designed to produce accurate changesets for root module outputs. Although we added a place for it in the plan model in Terraform 0.12, Terraform Core currently produces inaccurate changesets there which don't properly track the prior values. We're planning to rework Terraform Core's evaluation approach in a forthcoming release so it would itself be able to distinguish between the prior state and the planned new state to produce an accurate changeset, but this commit introduces a temporary stop-gap solution of implementing the logic up in the local backend code, where we can freeze a snapshot of the prior state before we take any other actions and then use that to produce an accurate output changeset to decide whether the plan has externally-visible side-effects and render any changes to output values. This temporary approach should be replaced by a more appropriately-placed solution in Terraform Core in a release, which should then allow further behaviors in similar vein, such as user-visible drift detection for resource instances.	6 years ago
Chris Carpenter	8f4f181151	Update taint.html.markdown ... Single qoute cause an `Invalid character` error.	6 years ago
Daniel Dreier	df39e0a806	Merge pull request #23989 from tatsuo48/fix_sample_code ... fix sample code	6 years ago
Nick Fagerlund	e358d6b618	website: Edit text of new TF_IGNORE env var docs (#24788) ... * website: Edit text of new TF_IGNORE env var docs Fixing one broken link, and tidying the sentences a bit. * typo Co-authored-by: Pam Selle <pam@hashicorp.com>	6 years ago
Alisdair McDiarmid	20483da548	website: Add docs for 0.13upgrade	6 years ago
Alisdair McDiarmid	9266e944fa	Merge pull request #24752 from hashicorp/alisdair/terraform-state-replace-provider-docs ... website: Add docs for state replace-provider	6 years ago
Martin Atkins	1ce3c60693	command/cliconfig: Explicit provider installation method configuration ... This set of commits allows explicit configuration of provider installation methods in the CLI config, overriding the implicit method selections.	6 years ago
Martin Atkins	dadec6ee9e	fixup docs	6 years ago
Martin Atkins	c6cbbcb79a	website: Initial documentation for provider_installation in the CLI config ... This is an initial draft of documentation for this new feature of the CLI configuration. This is mainly intended as a placeholder for now, because there are other documentation updates pending for the new provider namespacing and installation scheme and we'll likely want to revise these docs to better complement the broader documentation once it's written.	6 years ago
Alisdair McDiarmid	52d64127f7	website: Add docs for state replace-provider	6 years ago
Petros Kolyvas	7c278f9d80	Merge pull request #24479 from hashitop/f-update-doco-add-reference-tf_ignore-env_var ... Update documentation to add reference to the TF_IGNORE environment variable used for validating .terraformignore excluded files.	6 years ago
Kristin Laemmert	269d511481	command/providers: refactor with new provider types and functions ... The providers command has been refactored to use the modern provider types and ProviderRequirements() functions. This resulted in a breaking change to the output: it no longer outputs the providers by module and no longer prints `(inherited)` or `(from state)` to show why a provider is included. We decided that at this time it was best to stick with the existing functions and make this change, but if we get feedback from the community we will revisit. Additional tests to exercise providers in modules and providers from state have been included.	6 years ago
Danny Guo	b7b981fbe1	website/docs: Fix a typo in the import command docs (#24622)	6 years ago
hashitop	c73104686d	Add description about env var TF_IGNORE	6 years ago
Kim Ngo	d88729d922	registry: configurable client timeout (#24259) ... * registry: configurable client timeout * Update registry/client_test.go Fix env test cleanup Co-Authored-By: Alisdair McDiarmid <alisdair@users.noreply.github.com>	6 years ago
findkim	a3f26ccd12	website/docs/commands: document TF_REGISTRY_DISCOVERY_RETRY	6 years ago
Alisdair McDiarmid	081f02971d	command/logout: Add terraform logout command ... Use terraform logout to remove stored credentials for a remote service host.	6 years ago
Nick Fagerlund	a797152648	website: Remove extra copy of "Running Terraform in Automation", update links ... This document now lives at: - https://learn.hashicorp.com/terraform/development/running-terraform-in-automation ...and terraform.io has been redirecting to there for quite a while. This commit removes the extra copy so that the text of the two versions doesn't drift, and updates existing links to point to the new location.	6 years ago
Martin Atkins	778f1ab138	website: Documentation for the "terraform login" command (#22727) ... Co-authored-by: Alisdair McDiarmid <alisdair@users.noreply.github.com>	6 years ago
yokoyama tatsuo	a280e2ffea	fix sample code	6 years ago
Avi Zurel	96645d7ea7	website: Better example for running 0.12upgrade across many directories at once	6 years ago
Pam Selle	cd6c93774a	Update docs to reflect current behavior	6 years ago
Martin Atkins	2a95d98383	docs: terraform state show is not machine-readable ... In earlier versions of Terraform the result of terraform state show was in the pre-0.12 "flatmap" structure that was unable to reflect nested data structures. That was fixed in Terraform 0.12, but as a consequence this statement about the output being machine-parseable (which was debateable even in older versions) is incorrect. Fortunately, we now have "terraform show -json" to get output that is intentionally machine-parseable, so we'll recommend to use that instead here. The JSON output of that command is a superset of what's produced by "terraform state show", so should be usable to meet any use-case that might previously have been met by parsing the "terraform state show" output.	6 years ago
Martin Atkins	c06675c616	command: New -compact-warnings option ... When warnings appear in isolation (not accompanied by an error) it's reasonable to want to defer resolving them for a while because they are not actually blocking immediate work. However, our warning messages tend to be long by default in order to include all of the necessary context to understand the implications of the warning, and that can make them overwhelming when combined with other output. As a compromise, this adds a new CLI option -compact-warnings which is supported for all the main operation commands and which uses a more compact format to print out warnings as long as they aren't also accompanied by errors. The default remains unchanged except that the threshold for consolidating warning messages is reduced to one so that we'll now only show one of each distinct warning summary. Full warning messages are always shown if there's at least one error included in the diagnostic set too, because in that case the warning message could contain additional context to help understand the error.	6 years ago
Martin Atkins	2423f266fb	website: example of "terraform taint" with a grandchild module ... I've seen folks ask about how to express this in resource address syntax a number of times now, so adding this example here to illustrate how it looks when there are multiple levels of module to traverse through. This is redundant with other information further up the page, but having it as an entirely separate example gives an opportunity to include more introductory text to explain what the example is showing.	7 years ago