ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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.
This commit is contained in:
Alisdair McDiarmid 2020-09-09 11:15:02 -04:00
parent 069f379e75
commit 3419422891
1 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
website/docs/commands/cli-config.html.markdown
View File

@ -271,18 +271,21 @@ method.
The set of directories Terraform can select as filesystem mirrors depends on The set of directories Terraform can select as filesystem mirrors depends on
the operating system where you are running Terraform: the operating system where you are running Terraform:
* **Windows:** `%APPDATA%/HashiCorp/Terraform/plugins` * **Windows:** `%APPDATA%/terraform.d/plugins` and `%APPDATA%/HashiCorp/Terraform/plugins`
* **Mac OS X:** `~/Library/Application Support/io.terraform/plugins` and * **Mac OS X:** `$HOME/.terraform.d/plugins/`,
`~/Library/Application Support/io.terraform/plugins`, and
`/Library/Application Support/io.terraform/plugins` `/Library/Application Support/io.terraform/plugins`
* **Linux and other Unix-like systems**: Terraform implements the * **Linux and other Unix-like systems**:`$HOME/.terraform.d/plugins/`, and
[XDG Base Directory](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) [XDG Base Directory](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)
specification and appends `terraform/plugins` to all of the specified data directories as configured, after appending `terraform/plugins`.
data directories. Without any XDG environment variables set, Terraform Without any XDG environment variables set, Terraform will use
will use `~/.local/share/terraform/plugins`, `~/.local/share/terraform/plugins`,
`/usr/local/share/terraform/plugins`, and `/usr/share/terraform/plugins`. `/usr/local/share/terraform/plugins`, and `/usr/share/terraform/plugins`.
Terraform will create an implied `filesystem_mirror` method block for each of Terraform will create an implied `filesystem_mirror` method block for each of
the directories indicated above that exists when Terraform starts up. the directories indicated above that exists when Terraform starts up.
In addition, if a `terraform.d/plugins` directory exists in the current working
directory, it will be added as a filesystem mirror.
In addition to the zero or more implied `filesystem_mirror` blocks, Terraform In addition to the zero or more implied `filesystem_mirror` blocks, Terraform
also creates an implied `direct` block. Terraform will scan all of the also creates an implied `direct` block. Terraform will scan all of the