From 036779f873176ad38267360de9ad6ade6af78156 Mon Sep 17 00:00:00 2001 From: Anna Winkler <3526523+annawinkler@users.noreply.github.com> Date: Wed, 14 Dec 2022 13:51:34 -0700 Subject: [PATCH 1/2] Add information about possible network glitches --- website/docs/cloud-docs/run/cli.mdx | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/website/docs/cloud-docs/run/cli.mdx b/website/docs/cloud-docs/run/cli.mdx index 3f65f2e28..d8400f93a 100644 --- a/website/docs/cloud-docs/run/cli.mdx +++ b/website/docs/cloud-docs/run/cli.mdx @@ -250,3 +250,17 @@ Do you want to override the soft failed policy check? ## Options for Plans and Applies [Run Modes and Options](/cloud-docs/run/modes-and-options) contains more details about the various options available for plans and applies when you use the CLI-driven workflow. + +## Networking/Connection Issues + +Sometimes during a CLI-driven run, errors relating to network connectivity issues arise. Examples of these kinds of errors include: + +* `Client.Timeout exceeded while awaiting headers` +* `context deadline exceeded` +* `TLS handshake timeout` + +Sometimes there are network hiccups that are outside of our control. If you're seeing these kinds of errors, after making sure your network connection is operational, the following are a few common configuration settings to check: + +* Determine if there is any firewall software on your system that could be blocking the `terraform` command, and explicitly approve it. +* Verify that you're using a valid DNS server IP address. +* Remove any expired TLS certificates for your system. From d09a5b1882f40053f476e64fe27eb1d73d01fb20 Mon Sep 17 00:00:00 2001 From: Anna Winkler <3526523+annawinkler@users.noreply.github.com> Date: Wed, 1 Feb 2023 16:44:30 -0700 Subject: [PATCH 2/2] Update website/docs/cloud-docs/run/cli.mdx Co-authored-by: Matthew Garrell <69917312+mgarrell777@users.noreply.github.com> --- website/docs/cloud-docs/run/cli.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/cloud-docs/run/cli.mdx b/website/docs/cloud-docs/run/cli.mdx index d8400f93a..a40a3d4b1 100644 --- a/website/docs/cloud-docs/run/cli.mdx +++ b/website/docs/cloud-docs/run/cli.mdx @@ -259,8 +259,8 @@ Sometimes during a CLI-driven run, errors relating to network connectivity issue * `context deadline exceeded` * `TLS handshake timeout` -Sometimes there are network hiccups that are outside of our control. If you're seeing these kinds of errors, after making sure your network connection is operational, the following are a few common configuration settings to check: +Sometimes there are network problems beyond our control. If you have network errors, verify your network connection is operational. Then, check the following common configuration settings: -* Determine if there is any firewall software on your system that could be blocking the `terraform` command, and explicitly approve it. -* Verify that you're using a valid DNS server IP address. +* Determine if any firewall software on your system blocks the `terraform` command and explicitly approve it. +* Verify that you have a valid DNS server IP address. * Remove any expired TLS certificates for your system.