aws start

bpmct · bpmct · commit ea104434c5e4 · 2022-11-17T17:29:13.000Z
diff --git a/docs/images/quickstart/aws/securitygroup.png b/docs/images/quickstart/aws/securitygroup.png
diff --git a/examples/templates/aws-linux/README.md b/examples/templates/aws-linux/README.md
@@ -74,3 +74,13 @@ instances provisioned by Coder:
 `code-server` is installed via the `startup_script` argument in the `coder_agent`
 resource block. The `coder_app` resource is defined to access `code-server` through
 the dashboard UI over `localhost:13337`.
+
+### Agent is stuck "connecting" or "disconnected"
+
+This often occurs when the EC2 instance cannot reach your Coder access URL. If you are not using Coder's [public tunnel](https://coder.com/docs/coder-oss/latest/admin/configure#tunnel), you must [configure your access URL](https://coder.com/docs/coder-oss/latest/admin/configure#access-url) as a public address or one within the same VPC as workspaces.
+
+You can also troubleshoot by connecting directly into the instance and checking the agent logs. First, log in to the [AWS Console](https://console.aws.amazon.com) and create a security group that permits inbound SSH.
+
+```sh
+cat /tmp/coder-agent.log
+```
diff --git a/examples/templates/aws-linux/main.tf b/examples/templates/aws-linux/main.tf
@@ -124,6 +124,9 @@ users:
 - name: ${local.linux_user}
   sudo: ALL=(ALL) NOPASSWD:ALL
   shell: /bin/bash
+  # Uncomment to add SSH public key for debugging
+  # ssh-authorized-keys:
+  #   - ssh-rsa ...
 
 --//
 Content-Type: text/x-shellscript; charset="us-ascii"
@@ -176,6 +179,8 @@ resource "aws_instance" "dev" {
     # Required if you are using our example policy, see template README
     Coder_Provisioned = "true"
   }
+  # Uncomment to enable SSH access for debugging
+  # security_groups   = ["coder_debug"]
 }
 
 resource "coder_metadata" "workspace_info" {
diff --git a/examples/templates/docker/README.md b/examples/templates/docker/README.md
@@ -54,7 +54,7 @@ add the following features to your Coder template:
 
 ### Agent is stuck "connecting" or "disconnected"
 
-This often occurs because the container cannot reach your [access URL](https://coder.com/docs/coder-oss/latest/admin/configure#access-url). The container may also be missing `curl` which is required to download the agent.
+This often occurs when the container cannot reach your [access URL](https://coder.com/docs/coder-oss/latest/admin/configure#access-url). The container may also be missing `curl` which is required to download the agent.
 
 First, check the logs of the container:
 
diff --git a/examples/templates/gcp-linux/README.md b/examples/templates/gcp-linux/README.md
@@ -54,7 +54,7 @@ the dashboard UI over `localhost:13337`.
 
 ### Agent is stuck "connecting" or "disconnected"
 
-This often occurs because the virtual machine cannot reach your Coder access URL. If you are not using Coder's [public tunnel](https://coder.com/docs/coder-oss/latest/admin/configure#tunnel), you must [configure your access URL](https://coder.com/docs/coder-oss/latest/admin/configure#access-url) as a public address or one within the same VPC as workspaces.
+This often occurs when the virtual machine cannot reach your Coder access URL. If you are not using Coder's [public tunnel](https://coder.com/docs/coder-oss/latest/admin/configure#tunnel), you must [configure your access URL](https://coder.com/docs/coder-oss/latest/admin/configure#access-url) as a public address or one within the same VPC as workspaces.
 
 You can also use the SSH console to log into the VM and check the agent logs.
 
diff --git a/examples/templates/gcp-linux/main.tf b/examples/templates/gcp-linux/main.tf
@@ -2,7 +2,7 @@ terraform {
   required_providers {
     coder = {
       source  = "coder/coder"
-      version = "0.6.0"
+      version = "0.6.3"
     }
     google = {
       source  = "hashicorp/google"
@@ -56,6 +56,9 @@ resource "coder_agent" "main" {
     curl -fsSL https://code-server.dev/install.sh | sh  | tee code-server-install.log
     code-server --auth none --port 13337 | tee code-server-install.log &
   EOT
+
+  connection_timeout  = 20
+  troubleshooting_url = "https://github.com/coder/coder/tree/main/examples/templates/gcp-linux#troubleshooting"
 }
 
 # code-server
