From fe6092f325a494e0029b26829c8d0f455c0e5161 Mon Sep 17 00:00:00 2001 From: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> Date: Mon, 7 Feb 2022 18:45:07 -0500 Subject: [PATCH 1/2] Add line about how you can't use console during a run --- website/docs/cli/commands/console.mdx | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/website/docs/cli/commands/console.mdx b/website/docs/cli/commands/console.mdx index 2f7edcfa5..a9f8feac2 100644 --- a/website/docs/cli/commands/console.mdx +++ b/website/docs/cli/commands/console.mdx @@ -16,15 +16,12 @@ Usage: `terraform console [options]` This command provides an interactive command-line console for evaluating and experimenting with [expressions](/language/expressions). -This is useful for testing interpolations before using them in configurations, -and for interacting with any values currently saved in -[state](/language/state). +You can use it to test interpolations before using them in configurations +and to interact with any values currently saved in +[state](/language/state). If the current state is empty or has not yet been created, you can use the console to experiment with the expression syntax and +[built-in functions](/language/functions). You cannot use the console during a run because Terraform prevents read actions while it is writing new state. -If the current state is empty or has not yet been created, the console can be -used to experiment with the expression syntax and -[built-in functions](/language/functions). - -You can close the console with the `exit` command or by pressing Control-C +To close the console, enter the `exit` command or press Control-C or Control-D. For configurations using From 3c40dac0bc9a45d83a5e6987e3632ffa2be51c8d Mon Sep 17 00:00:00 2001 From: Laura Pacilio <83350965+laurapacilio@users.noreply.github.com> Date: Tue, 8 Feb 2022 16:22:44 -0500 Subject: [PATCH 2/2] Fix according to PR comments --- website/docs/cli/commands/console.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/cli/commands/console.mdx b/website/docs/cli/commands/console.mdx index a9f8feac2..40e3b5e6f 100644 --- a/website/docs/cli/commands/console.mdx +++ b/website/docs/cli/commands/console.mdx @@ -19,7 +19,7 @@ experimenting with [expressions](/language/expressions). You can use it to test interpolations before using them in configurations and to interact with any values currently saved in [state](/language/state). If the current state is empty or has not yet been created, you can use the console to experiment with the expression syntax and -[built-in functions](/language/functions). You cannot use the console during a run because Terraform prevents read actions while it is writing new state. +[built-in functions](/language/functions). The console holds a [lock on the state](/language/state/locking), and you will not be able to use the console while performing other actions that modify state. To close the console, enter the `exit` command or press Control-C or Control-D.