Commit Graph

6995 Commits

Author SHA1 Message Date
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
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
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