Commit Graph

7194 Commits

Author SHA1 Message Date
Laura Pacilio
83a700b313 Update version notes for custom conditions 2022-05-20 16:10:26 -04:00
Laura Pacilio
b2d3e594ca Remove duplicate versioning note for custom condition checks. 2022-05-20 16:07:27 -04:00
Laura Pacilio
f7c5d1b054 Add version note for env var credentials 1.2 work. 2022-05-20 16:04:37 -04:00
Laura Pacilio
54d084159f Add version note, fix typos, add link to environment variables 2022-05-20 16:00:53 -04:00
Laura Pacilio
55edc6a6af
Merge pull request #31049 from miyagawa-michiru/update-local-exec-arguments
`local-exec` documentation lacks on-destroy documentation
2022-05-19 11:02:38 -04:00
miyagawa-michiru
61271ef117 Add a missing word 2022-05-19 08:05:34 +09:00
James Bardin
f7f4a82619
Merge pull request #31063 from hashicorp/jbardin/v1.2-upgrade-guide
v1.2 upgrade guide
2022-05-18 13:59:39 -04:00
Laura Pacilio
179e108cd1
Update website/docs/language/expressions/custom-conditions.mdx 2022-05-18 13:49:44 -04:00
James Bardin
1a60b3b5be s/obsolete/outdated/ 2022-05-18 13:49:38 -04:00
James Bardin
975158a552
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 13:48:32 -04:00
James Bardin
43c78af1c0
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 13:48:08 -04:00
James Bardin
0855561db0 group obsolete TLS features in upgrade guide 2022-05-18 13:05:36 -04:00
James Bardin
6e70577a87 re-order upgrade sections 2022-05-18 12:46:12 -04:00
James Bardin
7566ab7c93
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:45:25 -04:00
James Bardin
3633de8bf5
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:41:51 -04:00
James Bardin
8166216ba6
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:41:44 -04:00
James Bardin
24663fbf26
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:41:39 -04:00
James Bardin
63cd25531f
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:41:27 -04:00
James Bardin
c658f85552
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:41:18 -04:00
James Bardin
6cb8e8bbad
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:40:52 -04:00
James Bardin
0dc7a1fa63
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:40:43 -04:00
James Bardin
694fb75679
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:40:12 -04:00
James Bardin
d07621944f
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:39:49 -04:00
James Bardin
797e592416
Update website/docs/language/upgrade-guides/1-2.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-18 12:39:16 -04:00
Laura Pacilio
edf9324a9e Add learn tutorial link 2022-05-18 12:22:32 -04:00
tombuildsstuff
05528e8c8a backend/azurerm: removing ADAL support 2022-05-18 16:56:10 +02:00
Laura Pacilio
35bc9943ec
Merge pull request #31012 from StefanSchoof/patch-1
Use different names for var and block
2022-05-18 10:45:37 -04:00
Laura Pacilio
e926021890
Merge pull request #31058 from hashicorp/non-interactive-workflows
Add warning about drift to cloud block environment variables
2022-05-18 10:43:37 -04:00
Laura Pacilio
953e0debe1
Update website/docs/cli/cloud/settings.mdx
Co-authored-by: rita <8647768+ritsok@users.noreply.github.com>
2022-05-18 10:38:44 -04:00
James Bardin
b56ff97653 v1.2 upgrade guide 2022-05-18 08:20:14 -04:00
StefanSchoof
650ada19b7
change also variable name in text 2022-05-18 07:59:47 +02:00
miyagawa-michiru
2bb83244f9 Update the explanation about 'when' option 2022-05-18 14:57:46 +09:00
Laura Pacilio
1666aa8463
Update website/docs/language/expressions/custom-conditions.mdx
Co-authored-by: Robin Norwood <rnorwood@hashicorp.com>
2022-05-16 16:43:15 -04:00
Laura Pacilio
5841db00b3 Change private to public dns :-) 2022-05-16 16:28:15 -04:00
Laura Pacilio
555ffdff6c Add warning about drift to cloud block environment variables 2022-05-16 14:56:58 -04:00
Laura Pacilio
1fd140ff83
Merge pull request #31010 from jhrcek/patch-1
Add missing syntax highlighting for terraform snippets
2022-05-16 13:00:05 -04:00
Laura Pacilio
e9025f8636
Merge pull request #31019 from sylvainmetayer/patch-1
Add swift to workspace docs
2022-05-16 12:57:10 -04:00
Sylvain METAYER
16d3fad714
Update website/docs/language/state/workspaces.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-05-16 18:41:41 +02:00
miyagawa-michiru
315d168cc0 Add an explanation about the argument 'when' for local-exec 2022-05-15 18:12:26 +09:00
Martin Atkins
289bb60ce1 core: Defer on transitive dependencies for data resources with conditions
When a data resource is used for the purposes of verifying a condition
about an object managed elsewhere (e.g. if the managed resource doesn't
directly export all of the information required for the condition) it's
important that we defer the data resource read to the apply step if the
corresponding managed resource has any changes pending.

Typically we'd expect that to come "for free" but unfortunately we have
a pragmatic special case in our handling of data resources where we
normally defer to the apply step only if a _direct_ dependency of the data
resource has a change pending, and allow a plan-time read if there's
a pending change in an indirect dependency. This allowed us to preserve
some compatibility with the questionable historical behavior of always
reading data resources proactively unless the configuration contains
unknown values, since the arguably-more-correct behavior would've been a
regression for anyone who had been depending on that before.

Since preconditions and postconditions didn't exist until now, we are not
constrained in the same way by backward compatibility, and so we can adopt
the more correct behavior in the case where a data resource has conditions
specified. This does unfortunately make the handling of data resources
with conditions subtly inconsistent with those that don't, but this is
a better situation than the alternative where it would be easy to get into
a trapped situation where the remote system is invalid and it's impossible
to plan the change that would make it valid again because the conditions
evaluate too soon, prior to the fix being applied.
2022-05-11 11:01:38 -07:00
Martin Atkins
4cffff24b1 core: Report reason for deferring data read until apply
We have two different reasons why a data resource might be read only
during apply, rather than during planning as usual: the configuration
contains unknown values, or the data resource as a whole depends on a
managed resource which itself has a change pending.

However, we didn't previously distinguish these two in a way that allowed
the UI to describe the difference, and so we confusingly reported both
as "config refers to values not yet known", which in turn led to a number
of reasonable questions about why Terraform was claiming that but then
immediately below showing the configuration entirely known.

Now we'll use our existing "ActionReason" mechanism to tell the UI layer
which of the two reasons applies to a particular data resource instance.
The "dependency pending" situation tends to happen in conjunction with
"config unknown", so we'll prefer to refer that the configuration is
unknown if both are true.
2022-05-09 11:12:47 -07:00
Sylvain METAYER
3b1b485f45
Add swift to workspace docs
Swift backend support workspace (cf https://github.com/hashicorp/terraform/issues/19993#issuecomment-672839820 )
2022-05-09 17:53:00 +02:00
Laura Pacilio
98f9d646ce
Merge pull request #30969 from hashicorp/add-note-about-spaces
Add warning about spaces in variable value assignment
2022-05-09 10:34:30 -04:00
StefanSchoof
7cb1cf7b63
Use different names for var and block
I think it is easier to understand, which refers to the var and which to the block, when the var has not the exact same name as the block
2022-05-06 09:47:03 +02:00
Dirk Leser
707f39b440
Added example with function argument expansion
Even if the expansion with three dots is explicity mentioned in https://www.terraform.io/language/expressions/function-calls#expanding-function-arguments the additional example would have helped me a lot as it is a common use case to "flatten" a list of maps.
2022-05-06 09:28:42 +02:00
Jan Hrcek
fd5020cac7
Add missing syntax highlighting for terraform snippets 2022-05-06 08:22:03 +02:00
Alisdair McDiarmid
b0f837e1f3
Fix custom conditions Markdown typo 2022-05-05 18:38:29 -04:00
Kevin Wang
f98cad3384
feat: pull over content for /docs (#30991)
* feat: pull over content for `/docs`

* chore: format json
2022-05-03 16:23:09 -04:00
Dan Slimmon
1f6d986595 Include something about how state is checked 2022-05-02 09:57:25 +00:00
Laura Pacilio
3eea9d709d Add warning about spaces in variable value assignment 2022-04-29 16:59:39 -04:00
Kevin Wang
488853be9c
fix: img/docs/concrete-plan.png (#30967) 2022-04-29 15:33:45 -04:00
Tigerblue77
2928967b41
Update apt.mdx
- Removed usage of `apt-key` which is deprecated and replaced by `gpg` command
- Removed usage of `curl` command which is not present by default on Debian systems
2022-04-28 14:58:56 +02:00
htamakos
4cfb6bc893
communicator/ssh: Add support SSH over HTTP Proxy (#30274)
Terraform's remote-exec provision hangs out when it execs on HTTP Proxy bacause it dosen't support SSH over HTTP Proxy. This commits enables Terraform's remote-exec to support SSH over HTTP Proxy.

* adds `proxy_*` fields to `connection` which add configuration for a proxy host
* if `proxy_host` set, connect to that proxy host via CONNECT method, then make the SSH connection to `host` or `bastion_host`
2022-04-27 16:59:17 -04:00
Tom Bamford
351fd9b119
Merge pull request #30936 from hashicorp/f/azurerm-backend-oidc
backend/remote-state/azure: support OIDC authentication
2022-04-27 19:34:53 +01:00
Tom Bamford
d08bc4463d
Azure Backend: support OIDC authentication 2022-04-27 19:27:30 +01:00
Alisdair McDiarmid
12c8f9498c json-output: Add output type to JSON format
Previously the supported JSON plan and state formats included only
serialized output values, which was a lossy serialization of the
Terraform type system. This commit adds a type field in the usual cty
JSON format, which allows reconstitution of the original value.

For example, previously a list(string) and a set(string) containing the
same values were indistinguishable. This change serializes these as
follows:

{
  "value": ["a","b","c"],
  "type": ["list","string"]
}

and:

{
  "value": ["a","b","c"],
  "type": ["set","string"]
}
2022-04-27 13:30:15 -04:00
Craig Wright
e217c0c53a
Merge pull request #30938 from jensenbox/patch-1
chore: Typo fix (`retuns` -> `returns`)
2022-04-26 18:32:41 -07:00
Ryoh Akiyoshi
9b4600cc23
website: Fix an example for urlencode function
The example did not reflect the actual behavior of escaping spaces.
2022-04-26 17:38:47 -07:00
Christian Jensen
85a081bd2a
chore: Typo fix
Fix a mispelled word.
2022-04-26 15:56:32 -07:00
James Bardin
0501980b46
Update website/docs/language/resources/behavior.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-26 18:17:58 -04:00
James Bardin
4e95b24022
Update website/docs/language/meta-arguments/lifecycle.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-26 18:17:52 -04:00
James Bardin
6c15cab211
Update website/docs/language/meta-arguments/lifecycle.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-26 18:17:46 -04:00
James Bardin
840a7437c2
Update website/docs/language/meta-arguments/lifecycle.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-26 18:17:41 -04:00
James Bardin
7b40b31697 replace_triggered_by docs 2022-04-25 18:43:38 -04:00
Kevin Wang
2563bf3f96
feat: support local preview, post split; add deploy preview (#30814)
* chore: support local preview, post split

* feat: deploy preview

* update script perms
- chmod +x ./website/scripts/website-build.sh

* npm i

* chore: website-build uses 'kevin/terraform-split'

* deploy preview test

* chore: test

* PREVIEW_DIR & CLONE_DIR = preview

* rm dupe preview path

* empty commit

* ../data & ..docs

* website-preview

* remove REPO var

* move `intro` and `guides` back to where they were

* empty commit

* chore move `intro` and `guides`

* chore: copy over images

* move images into `/website`
- content API requires this

* chore: `CURRENT_GIT_BRANCH`

* fix: `CURRENT_GIT_BRANCH`

* fix `CURRENT_GIT_BRANCH`

* debug current dir

* fix `CURRENT_GIT_BRANCH`

* chore: comment CURRENT_GIT_BRANCH

* Update Makefile

* Update website/scripts/website-build.sh

* optimize images

* chore(Makefile): move vars to top

* remove branch
2022-04-21 13:58:16 -04:00
Laura Pacilio
e68ad5ec46 more edits 2022-04-20 18:57:50 -04:00
Laura Pacilio
912e6ff6de Apply suggestions from PR review 2022-04-20 18:54:50 -04:00
Laura Pacilio
a0ebb94fb5
Merge branch 'main' into update-TF-WORKSPACE-variable 2022-04-20 18:40:26 -04:00
Sebastian Rivera
f63ef2b5ef Rename cloud env vars to use TF_CLOUD prefix 2022-04-20 14:34:53 -04:00
Laura Pacilio
d3e660d912
Merge pull request #30772 from hashicorp/laura-update-pre-post-conditions
[WIP] Preconditions and Postconditions Content Updates
2022-04-20 12:25:43 -04:00
Laura Pacilio
b1d9339368 Final formatting nits 2022-04-20 12:19:29 -04:00
Laura Pacilio
3c7c5bbd21 add links to function and expressions; move result types back to conditionals page (oops) 2022-04-20 12:06:50 -04:00
Laura Pacilio
2a206c7984 fix incorrect HCL syntax for example 2022-04-20 11:49:33 -04:00
Laura Pacilio
7a43db405c Add link to operators page and all out other types 2022-04-20 11:46:37 -04:00
Tom Harvey
2eb9118cd1
backend/remote-state/azure: defaulting the Azure Backend to use MSAL (#30891)
* backend/remote-state/azure: defaulting the Azure Backend to use MSAL

Fixes #30881

* backend/remote-state/azurerm: deprecating `use_microsoft_graph`
2022-04-20 17:31:44 +02:00
Laura Pacilio
ba3bb5ad5d Apply suggestions from PR review 2022-04-20 11:30:20 -04:00
Laura Pacilio
686dbcdb8d fix confusing sentence on lifecycle page 2022-04-20 11:24:23 -04:00
Laura Pacilio
4d4d774aef fix confusing sentence on resources page 2022-04-20 11:23:15 -04:00
Laura Pacilio
ce757244f2 fix confusing sentence in outputs 2022-04-20 11:22:11 -04:00
Laura Pacilio
f660f54b87 Final nits from review 2022-04-20 11:21:11 -04:00
Laura Pacilio
e8743143e3
Update website/docs/language/data-sources/index.mdx
Co-authored-by: Alisdair McDiarmid <alisdair@users.noreply.github.com>
2022-04-20 11:17:45 -04:00
Laura Pacilio
87b09b1ee1 Fix broken HCL in example 2022-04-20 11:17:16 -04:00
Brandon Croft
1943af51a2
fix(creds): allow periods in TF_TOKEN_... credentials vars 2022-04-15 12:38:14 -06:00
Kevin Wang
545346b331
chore: move content into docs (#30837) 2022-04-14 12:04:35 -04:00
Shanee D
ed59bd7299
fix: Fix typo in v1.0 upgrade guide 2022-04-13 16:13:20 -07:00
Laura Pacilio
201c9168fa Clarify that users can set TF_WORKSPACE and use tags 2022-04-13 16:39:28 -04:00
Brandon Croft
8138fb7b29
Apply suggestions from documentation review
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-13 13:50:11 -06:00
Brandon Croft
fda05f3d44
feat(credentials): allow hyphens to be encoded as __ in variables
Hyphen characters are allowed in environment variable names, but are not valid POSIX variable names. Usually, it's still possible to set variable names with hyphens using utilities like env or docker. But, as a fallback, host names may encode their hyphens as double underscores in the variable name. For the example "café.fr", the variable name "TF_TOKEN_xn____caf__dma_fr" or "TF_TOKEN_xn--caf-dma_fr"
may be used.
2022-04-13 13:49:59 -06:00
Brandon Croft
dff6a8431c
Apply doc suggestions from code review
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-13 13:49:58 -06:00
Brandon Croft
307326fa3a
allow remote service creds to be configured using env
Introduces a new method of configuring token service credentials using a host-specific environment variable. This configuration was previously possible using the [terraform-credentials-env](https://github.com/apparentlymart/terraform-credentials-env) credentials helper.

This new method is now consulted first, as it is seen to be the most proximate source of credentials before CLI configuration while still falling back to the credentials helper.
2022-04-13 13:49:57 -06:00
Kevin Wang
8eaf7fe85e
chore: vercel config (#30831)
- follows: https://github.com/hashicorp/terraform-cdk/pull/1611
2022-04-12 12:19:28 -04:00
Sebastian Rivera
f95c7935c9
Update website/docs/cli/cloud/settings.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-11 14:33:13 -04:00
Sebastian Rivera
4c3429f1a0 Update docs to explain new TF_WORKSPACE behavior for cloud config 2022-04-11 14:09:24 -04:00
Laura Pacilio
f9462d5d51 Update links to say "Custom Condition Checks" 2022-04-07 16:25:09 -04:00
Laura Pacilio
3ed8c5c467 Fix in-text link 2022-04-07 13:51:56 -04:00
Laura Pacilio
4c097842df Move conditionals information to conditional expressions page 2022-04-07 13:48:44 -04:00
Laura Pacilio
375b3583fd APply suggestions from PR review 2022-04-07 12:12:13 -04:00
Sebastian Rivera
9c0a8f7e35 Update env variable docs section to include TF_WORKSPACE 2022-04-07 11:46:36 -04:00
Laura Pacilio
3bc3bc52f8
Update website/docs/language/expressions/custom-conditions.mdx
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
2022-04-07 11:40:01 -04:00
Laura Pacilio
b997c983a5
Update website/docs/language/expressions/custom-conditions.mdx
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
2022-04-07 11:39:41 -04:00
Laura Pacilio
4ab955eeab
Update website/docs/language/expressions/custom-conditions.mdx
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
2022-04-07 10:13:41 -04:00
Laura Pacilio
6b986c94bc
Update website/docs/language/expressions/custom-conditions.mdx
Co-authored-by: Martin Atkins <mart@degeneration.co.uk>
2022-04-07 10:12:49 -04:00
Laura Pacilio
d69cb58ff5 Add additional sections to condition expressions section 2022-04-06 17:01:04 -04:00
Laura Pacilio
eea860e0cf Fixing typos and doing a read through 2022-04-06 16:55:43 -04:00
Laura Pacilio
04d329a9e1 Add references to custom conditions on related pages 2022-04-06 16:11:36 -04:00
Laura Pacilio
5803963be8 more nitpicks 2022-04-06 15:45:27 -04:00
Laura Pacilio
62a7b51ba7 more edits 2022-04-06 15:41:02 -04:00
Laura Pacilio
3ae238a448 More language edits 2022-04-06 14:57:20 -04:00
Laura Pacilio
af7e688859 more language cleanup for clarity 2022-04-05 17:01:21 -04:00
Laura Pacilio
b2576a3df3 Update page name to Custom Conditions per feedback 2022-04-05 15:50:24 -04:00
Jane
4de27fc52b
Update website/docs/language/settings/terraform-cloud.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-04-01 14:22:14 +08:00
Jane
5b6eaa4fea
Add hostname argument to cloud block 2022-03-31 09:50:37 +08:00
Laura Pacilio
040985f6e1 more edits 2022-03-30 17:59:03 -04:00
Laura Pacilio
b0f491f2d1 update section title 2022-03-30 17:57:03 -04:00
Laura Pacilio
d12b170ef2 more page edits for flow and style 2022-03-30 17:48:43 -04:00
Laura Pacilio
5effda4170 Rename page again 2022-03-30 17:18:16 -04:00
Laura Pacilio
42d73fe324 Rename page in sidebar and change filename 2022-03-30 17:11:23 -04:00
Laura Pacilio
2449fadf06 Revising preconditions and postconditions 2022-03-30 17:00:13 -04:00
Sebastian Rivera
100031a2d9 Update docs to include TF_HOSTNAME env var 2022-03-30 11:54:51 -04:00
Sebastian Rivera
b4b4f4e9d9
Merge pull request #30719 from hashicorp/sebasslash/add-tf-org-env-var
Add TF_ORGANIZATION env var support
2022-03-30 11:41:07 -04:00
Laura Pacilio
38dd0ef2f3
Merge pull request #30423 from noce2/patch-1
Docs Update: Show example of state lock table access control
2022-03-29 15:20:49 -04:00
Nsikan
a813854a82
Update website/docs/language/settings/backends/s3.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-03-29 16:40:59 +01:00
Alisdair McDiarmid
120d096615
Merge pull request #30747 from george-mengelberg/patch-1
Description of '-' symbol as used in format()
2022-03-28 12:58:12 -04:00
Laura Pacilio
b5c0955cb9
Merge pull request #30712 from hashicorp/file-provisioner-powershell-warning
Add PowerShell note to file provisioner page
2022-03-28 11:13:28 -04:00
Sebastian Rivera
b260883a98 Update docs to mention TF_ORGANIZATION env var 2022-03-26 16:44:16 -04:00
george-mengelberg
d7316e79ca
Description of '-' symbol as used in format()
The existing description for the '-' symbol as use in format() stated that the result would padded spaces to the left.  When tested in via 'terraform console' using format("%-10.1f", 3) the result was "3.0       "

Terraform v1.1.7
2022-03-26 08:26:44 -07:00
ritsok
bef18c47cb Link workflow tutorials from docs 2022-03-23 16:38:36 -04:00
Laura Pacilio
d74c4972d7 Add more context to note 2022-03-21 14:09:25 -04:00
Laura Pacilio
881fbd1971 Add PowerShell note to file provisioner page 2022-03-21 14:03:18 -04:00
Laura Pacilio
0ba0fe667c Add period 2022-03-18 17:18:25 -04:00
Laura Pacilio
c7afb7db94 Add note about powershell formatting 2022-03-18 17:15:24 -04:00
Anna Winkler
3727191078
Merge pull request #30671 from hashicorp/aw/clarify-var
Remove incorrect sentence
2022-03-16 08:35:03 -06:00
Craig Wright
c5d7bd3e65
Merge pull request #30674 from loekd/patch-5
Update toset.mdx
2022-03-15 17:31:41 -07:00
Laura Pacilio
7c0cbaa407
Merge pull request #30281 from Mukesh05/patch-3
Terraform may be misled, not provider
2022-03-15 16:50:36 -04:00
Laura Pacilio
50d49d0b0d
Merge pull request #30649 from dragondrop-cloud/main
Documentation Update: Capture `cloud`/ `backend` block override behavior in docs
2022-03-15 16:47:23 -04:00
GoodmanBen
659fb09fc1 fix: cleaner syntax 2022-03-15 16:36:04 -04:00
GoodmanBen
b8d8461dbb no new line changes in terraform-cloud.mdx 2022-03-15 11:26:04 -04:00
GoodmanBen
12f125d958 remove override interjection on terraform-cloud docs 2022-03-15 11:25:05 -04:00
Loek Duys
c6fa1e70ef
Update toset.mdx
Fix output in `toset`
```
toset(["a", "b", 3])
toset([
  "3",
  "a",
  "b",
])
```

This is the actual output from the tf console, using Terraform v1.1.5 on windows_amd64
2022-03-15 13:48:14 +01:00
GoodmanBen
e9043cdcad fix: suggested changes 2022-03-14 19:03:53 -04:00
Anna Winkler
300ab16939
Remove incorrect sentence
There is always a configuration for import and using `-var` is always allowed.
2022-03-14 14:01:17 -06:00
Laura Pacilio
53e3f044b0
Update website/docs/cli/commands/refresh.mdx 2022-03-14 12:18:54 -04:00
Laura Pacilio
c74937dc93
Update website/docs/cli/commands/refresh.mdx 2022-03-14 12:18:50 -04:00
Laura Pacilio
63e0b4a5af
Update website/docs/cli/commands/refresh.mdx 2022-03-14 12:18:45 -04:00
Nsikan Essien
880a4631a2
Add dyanmo docs link and snippet comments 2022-03-14 10:35:34 +00:00
Nsikan
2cda0936bc
Update website/docs/language/settings/backends/s3.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-03-14 10:29:19 +00:00
Till Hoffmann
c847e6634f
Add type of resource id 2022-03-11 13:07:28 +01:00
Till Hoffmann
cfe6e5168a
Add type of resource id 2022-03-11 13:06:28 +01:00
GoodmanBen
478b4e0aea fix: tighten behavior description 2022-03-10 19:01:58 -05:00
GoodmanBen
32d9aa0ffd build: updated documentation reflecting cloud backend override functionality 2022-03-10 18:56:58 -05:00
Laura Pacilio
821064edd3
Merge pull request #30637 from kderck/patch-2
Change aws.dest to aws.dst
2022-03-10 18:08:29 -05:00
Kyle Davies
0ea6874bc1
Change aws.dest to aws.dst
Documentation is wrong the `configuration_aliases` should be `[ aws.src, aws.dst ]` not `[ aws.src, aws.dest ]`.
2022-03-09 20:26:10 +00:00
savage-tm
d6a98ac22b
Document logical operators not short-circuiting
Including a note about logical operators not short-circuiting will make the documentation clearer and more useful. https://github.com/hashicorp/terraform/issues/24128 includes examples of people being caught out by this lack of clarity.
2022-03-09 17:10:06 +13:00
Alisdair McDiarmid
f21d0e8bf6 website: Update docs for check rule error messages 2022-03-04 15:39:31 -05:00
Laura Pacilio
ad1ba5ef12 fix broken link on provisioners connection page 2022-02-24 18:15:05 -05:00
Drew Hodun
a26b551d47 added github.com commit reference example 2022-02-22 11:09:22 -05:00
Laura Pacilio
68e70d71d4
Merge pull request #30483 from bpar476/patch-1
Adds documentation to `substr` function to cover when `length` exceeds input length
2022-02-15 11:27:47 -05:00
Ben Partridge
252865c6a0
Improvements to wording of substr function documentation
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-02-15 10:23:37 +11:00
Nsikan Essien
b5300fc793
Incorporate feedback on policy snippet explanation 2022-02-14 18:45:30 +00:00
Alisdair McDiarmid
d8018270a7
Merge pull request #30138 from hashicorp/alisdair/json-module-call-providers-mapping
jsonconfig: Improve provider configuration output
2022-02-10 10:33:47 -05:00
Alisdair McDiarmid
0a9503812d
Merge pull request #30476 from hashicorp/alisdair/fix-type-marks
cli: Prevent complex uses of the console-only `type` function
2022-02-10 10:23:07 -05:00
Alisdair McDiarmid
98f80bc5da website: Explain limitations of type function 2022-02-10 06:12:58 -05:00
Laura Pacilio
24cffb5ff3 Soften language for determining run environment 2022-02-09 17:41:12 -05:00
Laura Pacilio
422b47618c Change name example to match new edits 2022-02-09 17:37:06 -05:00
Laura Pacilio
8be2c4a397 fix link 2022-02-09 14:30:02 -05:00
Laura Pacilio
faffa11e08 Update workspaces page 2022-02-09 14:21:46 -05:00
Laura Pacilio
ba0e2c1133 Update remote backend page to clarify workspace.name expression 2022-02-09 14:10:11 -05:00
Laura Pacilio
c1dc94a3d2
Merge pull request #30488 from hashicorp/update-console-docs
Update Console Command Documentation
2022-02-08 16:36:36 -05:00
Laura Pacilio
3c40dac0bc Fix according to PR comments 2022-02-08 16:22:44 -05:00
Craig Wright
3af6e82463
Merge pull request #30485 from salob/patch-1
Removing unnecessary comma from a single entry list example.
2022-02-08 11:59:44 -08:00
Laura Pacilio
fe6092f325 Add line about how you can't use console during a run 2022-02-07 18:45:07 -05:00
Laura Pacilio
7eee8c674e Remove extra spaces 2022-02-07 18:16:16 -05:00
Laura Pacilio
879edcae72 wording changes 2022-02-07 18:09:07 -05:00
Alisdair McDiarmid
f5b90f84a8 jsonconfig: Improve provider configuration output
When rendering configuration as JSON, we have a single map of provider
configurations at the top level, since these are globally applicable.
Each resource has an opaque key into this map which points at the
configuration data for the provider.

This commit fixes two bugs in this implementation:

- Resources in non-root modules had an invalid provider config key,
  which meant that there was never a valid reference to the provider
  config block. These keys were prefixed with the local module name
  instead of the path to the module. This is now corrected.

- Modules with passed provider configs would point to either an empty
  provider config block or one which is not present at all. This has
  been fixed so that these resources point to the provider config block
  from the calling module (or wherever up the module tree it was
  originally defined).

We also add a "full_name" key-value pair to the provider config block,
with the entire fully-qualified provider name including hostname and
namespace.
2022-02-07 15:05:58 -05:00
sian
d81335a55e
delete comma from single entry list 2022-02-07 18:12:26 +00:00
Laura Pacilio
6e399dfbe0 Update filename 2022-02-07 12:04:50 -05:00
Laura Pacilio
834f65e4f0 Fix formatting issues that would prevent website from loading 2022-02-07 11:59:28 -05:00
Ben Partridge
fa8a87fab5
Adds documentation to substr function to cover when length longer than input string
The `substr` function allows the `length` parameter to be longer than the remaining characters in the input after the offset. This is useful for when you want to truncate a string to a maximum number of characters. However, the documentation isn't clear on this so I had to do a test deployment to confirm the behaviour after finding the behaviour in an old issue https://github.com/hashicorp/terraform/issues/15751
2022-02-07 15:12:22 +11:00
Alisdair McDiarmid
0634c9437a
Merge pull request #30401 from hashicorp/f-preconditions-postconditions-rebased
Preconditions and Postconditions
2022-02-02 15:31:03 -05:00
Laura Pacilio
a794c80e0d final nits 2022-01-31 14:17:36 -05:00
Laura Pacilio
d14e04bf36 Fix notes according to PR feedback 2022-01-31 14:03:03 -05:00
Martin Atkins
f1b7f12f1c website: Initial draft docs for Preconditions and Postconditions 2022-01-31 14:02:53 -05:00
Laura Pacilio
a2f83ef7b6 Try to fix wording so it's clearer and more cohesive 2022-01-28 15:28:35 -05:00
Laura Pacilio
6e80276cc9 Remove invisible space 2022-01-28 14:44:56 -05:00
Mukesh Kumar
5b35c8c098
Update purpose.mdx
Update  "Mapping to the Real World" section
2022-01-28 19:15:12 +05:30
Laura Pacilio
f56c7c1c85 Make language in callouts more user friendly 2022-01-27 17:05:45 -05:00
Laura Pacilio
dca94a9eaf fix verb tense 2022-01-27 16:58:17 -05:00
Laura Pacilio
aa3a046af3 final nits 2022-01-27 16:56:50 -05:00
Laura Pacilio
1a66861aaf A couple other tweaks 2022-01-27 16:53:25 -05:00
Laura Pacilio
238396567d Making replace flag clearer and making plan options clearer 2022-01-27 16:00:08 -05:00
Laura Pacilio
6a02fbaef3 Fixing some final typos and nits that robin found! 2022-01-26 20:06:49 -05:00
Craig Wright
ca02b55fba
Merge pull request #30409 from tyron/fix-module-outputs-reference
Fix reference to child module in outputs docs
2022-01-26 15:47:42 -08:00
Laura Pacilio
4188c4c518 fix image references on intro page 2022-01-26 18:21:09 -05:00
Laura Pacilio
fb4b5c4d81
Merge pull request #30399 from hashicorp/add-new-intro-docs
Revamp Into to Terraform
2022-01-26 17:57:50 -05:00
Laura Pacilio
4ced2181ca Update SDN tutorials to recommended ones 2022-01-26 16:30:05 -05:00
Nsikan
93762b1abe
Show example of state lock table access control 2022-01-26 21:23:05 +00:00
Laura Pacilio
d5b0f44e37
Update website/intro/index.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:12:12 -05:00
Laura Pacilio
8ab9edf8ca
Update website/intro/index.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:12:04 -05:00
Laura Pacilio
4a8b4b311d
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:52 -05:00
Laura Pacilio
2201ebc075
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:47 -05:00
Laura Pacilio
2209b00167
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:42 -05:00
Laura Pacilio
0539155943
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:31 -05:00
Laura Pacilio
283e3c8ddb
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:24 -05:00
Laura Pacilio
10b1f85991
Update website/intro/use-cases.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:16 -05:00
Laura Pacilio
2402431679
Update website/intro/terraform-editions.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:11:10 -05:00
Laura Pacilio
f767628163
Update website/intro/terraform-editions.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:10:54 -05:00
Laura Pacilio
749507dd6a
Update website/intro/terraform-editions.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:10:34 -05:00
Laura Pacilio
044ed1c65a
Update website/intro/terraform-editions.mdx
Co-authored-by: Judith Malnick <judith.patudith@gmail.com>
2022-01-26 16:10:27 -05:00
Laura Pacilio
9e28fc44cd
Merge branch 'main' into fix-remote-backend-references 2022-01-26 11:47:19 -05:00
Laura Pacilio
53aa84576f
Update website/docs/language/state/remote-state-data.mdx
Co-authored-by: Nick Fagerlund <nick.fagerlund@gmail.com>
2022-01-26 11:43:16 -05:00
Laura Pacilio
1b1b5225a2
Update website/docs/language/state/remote-state-data.mdx
Co-authored-by: Nick Fagerlund <nick.fagerlund@gmail.com>
2022-01-26 11:42:22 -05:00
Laura Pacilio
e9d79f5284
Update website/docs/cli/import/index.mdx
Co-authored-by: Nick Fagerlund <nick.fagerlund@gmail.com>
2022-01-26 11:41:57 -05:00
Laura Pacilio
11a450d341 Final editing pass 2022-01-26 11:18:18 -05:00
Tyron
322622a0f4
fix reference to module
References to child modules should use the resource name, not their path
2022-01-25 20:54:20 -05:00
Laura Pacilio
9953260083
Merge pull request #30296 from hashicorp/fix-provisioners-content
Fix provisioners content
2022-01-24 13:49:28 -05:00
Laura Pacilio
95adde5dc9 Update vs. index page to say "Alternatives" and include a list on the page for SEO 2022-01-24 12:29:54 -05:00
Laura Pacilio
f1b36873e1 Update Use Cases page copy 2022-01-24 12:25:20 -05:00
Laura Pacilio
5e61890139 Add editions page and update sidebar 2022-01-24 12:19:19 -05:00
Laura Pacilio
a00306474d Add new content for intro page 2022-01-24 12:09:13 -05:00
Laura Pacilio
20e740ef88 Final formatting and langauge nits 2022-01-21 11:01:37 -05:00
Laura Pacilio
9f4c4ff093 Update note to be more direct :) 2022-01-21 10:48:27 -05:00
Laura Pacilio
1d53273b7a Language nits 2022-01-20 11:28:52 -05:00
Laura Pacilio
29a4591cf2 Fix warning notes 2022-01-20 10:57:38 -05:00
GiannakopoulosJ
13907690a2
Typo in zipmap documentation
zipmap does not produce a map with comma in terraform cli
tested with Terraform v1.1.3
2022-01-19 16:02:24 +02:00
Mukesh Kumar
149e5abe37
Update purpose.mdx
updated the document as per suggestion by Craig.
2022-01-19 12:41:29 +05:30
Mukesh Kumar
0b178d5867
Update website/docs/language/state/purpose.mdx
Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-01-19 11:49:25 +05:30
Mukesh Kumar
24af4e447f
Update website/docs/language/state/purpose.mdx
_provider_  is appropriate here.

Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-01-19 11:49:10 +05:30
Laura Pacilio
ec17cbaeee update additional references to overview page 2022-01-18 14:25:28 -08:00
Laura Pacilio
20e9f30c3d formatting nits 2022-01-18 14:25:28 -08:00
Laura Pacilio
63106da0b9 Language updates 2022-01-18 14:25:28 -08:00
Laura Pacilio
5cb8be0d50 Update nav to remove overview page that no longer exists 2022-01-18 14:07:40 -08:00
Laura Pacilio
5d24146f17 Oops edited the wrong layout file 2022-01-18 14:07:40 -08:00
Laura Pacilio
bfefb7405e Update layout file to remove deleted page 2022-01-18 14:07:40 -08:00
Laura Pacilio
fc4ceedc6d Remove overview page and update notes on provisioner pages 2022-01-18 14:07:40 -08:00
Laura Pacilio
5f61140655
Merge pull request #30332 from hashicorp/fix-broken-links-1-10
Fix broken links to external docs
2022-01-11 10:40:12 -05:00
Martin Atkins
beb9432155 website: CLI state manipulation section de-emphasize old features
Previously the "terraform state ..." subcommands were the only way to
perform various manipulations of the state, but in recent Terraform
versions we have replaced these with better options.

Since these pages seem to already have pretty good search engine
optimization for the use-cases they are describing, we'll prioritize
mentioning the new approaches and only mention the now-deprecated or
de-emphasized features as a secondary approach.

Specifically:
 - Describe the -replace=... planning option in preference to
   "terraform taint", and present taint as primarily a mechanism for
   Terraform to use itself, as opposed to something end-users should
   typically use directly.
 - Introduce the config-based refactoring features before describing
   "terraform state mv".

The older features here are still applicable in some situations and are
required for those still using older versions of Terraform, so we will
retain the information about them for now while aiming to be clearer in
each case about which is our preferred, modern approach.
2022-01-11 07:36:20 -08:00
Laura Pacilio
1b7e7b967d Fix broken links to external docs 2022-01-10 17:49:49 -05:00
Laura Pacilio
f4eb0ed24d
Merge pull request #30280 from Mukesh05/patch-2
Update local values definition
2022-01-07 10:22:57 -05:00
Mukesh Kumar
3ac334f267
Update website/docs/language/values/locals.mdx
Thank you. Your suggestion to use "instead of" makes the sentence even more easy to understand.

Co-authored-by: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com>
2022-01-07 05:52:12 +05:30
Martin Atkins
087c2f06ee website: Documentation of how provisioners upload files
We recently made a change to how provisioners upload files in order to
address an unintended remote code execution vector when using SSH, which
revealed that we had not previously documented well enough the expected
contract for how provisioners upload files to remote systems, and so some
users were depending on unintended consequences of the the bug now fixed.

We are retaining the fix on security-related grounds, but this is a good
prompt to be clearer in the docs about what exactly Terraform is doing
when asked to upload files over SSH and WinRM, so users can understand
what is supported and write their configurations accordingly.

This also includes an additional section to the v1.1 upgrade guide, since
we apparently neglected to document this intentional breaking change in
the first draft of that page.

Of course, provisioners as a whole remain a last resort, and so we're
documenting this as hopefully a helpful aid to those who have no other
option, and not meaning in any way to recommend their use for any new
use-cases.
2022-01-06 13:04:55 -08:00
Laura Pacilio
870116c509 more langauge edits 2022-01-06 11:48:13 -05:00
Laura Pacilio
fbf02d6342 Language edits 2022-01-06 11:46:08 -05:00
Laura Pacilio
6ef9cf652e
Merge pull request #30270 from addison-grant/patch-1
Update variables.mdx to fix typo
2022-01-06 11:14:46 -05:00
Laura Pacilio
8b69d24147 Update remote state data source page 2022-01-04 16:31:52 -05:00
Laura Pacilio
96b31fb1d3 Update core workflow page 2022-01-04 15:43:52 -05:00
Laura Pacilio
5792973dd6 Update language on import command page 2022-01-04 15:22:12 -05:00
Laura Pacilio
cab5305191 Fix formatting 2022-01-04 14:58:31 -05:00
Dylan Staley
a8bc7a0170
Merge pull request #30237 from hashicorp/ds.submodule-nav-main
Store website nav files (main)
2022-01-04 11:45:49 -08:00
Martin Atkins
74761b2f8b getmodules: Use go-getter v1.5.10 and return to upstream GitGetter
There was an unintended regression in go-getter v1.5.9's GitGetter which
caused us to temporarily fork that particular getter into Terraform to
expedite a fix. However, upstream v1.5.10 now includes a
functionally-equivalent fix and so we can heal that fork by upgrading.

We'd also neglected to update the Module Sources docs when upgrading to
go-getter v1.5.9 originally and so we were missing documentation about the
new "depth" argument to enable shadow cloning, which I've added
retroactively here along with documenting its restriction of only
supporting named refs.

This new go-getter release also introduces a new credentials-passing
method for the Google Cloud Storage getter, and so we must incorporate
that into the Terraform-level documentation about module sources.
2022-01-03 11:44:16 -08:00
Mukesh Kumar
3af1950adf
Terraform may be misled, not provider
Provider is not misled into thinking. Terraform may be misled into thinking that all of the managed objects have been deleted . So, Terraform removes all of the tracked objects from the state file.
2022-01-03 07:26:48 +05:30