From 9d9fc0708aa73665e6a1049480d52f03842849cf Mon Sep 17 00:00:00 2001 From: Eric Paulsen Date: Mon, 20 Sep 2021 11:30:20 -0400 Subject: [PATCH 1/4] add EKS troubleshooting steps --- setup/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup/installation.md b/setup/installation.md index 383855381..7b7024f6e 100644 --- a/setup/installation.md +++ b/setup/installation.md @@ -142,7 +142,7 @@ kubectl config set-context --current --namespace=coder ## Logging -At this time, we recommend review Coder's default +At this time, we recommend reviewing Coder's default [logging](../guides/admin/logging.md) settings. Logs are helpful for monitoring the health of your cluster and troubleshooting, and Coder offers you several options for obtaining these. From b238aec352b827f668c04ed4837bc10056704171 Mon Sep 17 00:00:00 2001 From: Eric Paulsen Date: Mon, 20 Sep 2021 11:35:46 -0400 Subject: [PATCH 2/4] let's try that again --- setup/installation.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/setup/installation.md b/setup/installation.md index 7b7024f6e..eb52a44ba 100644 --- a/setup/installation.md +++ b/setup/installation.md @@ -166,3 +166,18 @@ options for obtaining these. in, Coder will prompt you to change your password. At this point, you're ready to proceed to [configuring Coder](configuration.md). + +## EKS Troubleshooting + +If you're unable to access your Coder deployment via the external IP generated +by EKS, this is likely due to Load Balancer health checks failing. To resolve +this issue, set the `externalTrafficPolicy` helm value to `Cluster` by running +the following command: + +```console +helm upgrade --install coder coder/coder --set coderd.serviceSpec.externalTrafficPolicy=Cluster +``` + +Note that setting `externalTrafficPolicy` to `Cluster` masks the source IP +address of your Coder users. For more information on this value, [see the +Kubernetes documentation](https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip). From f58e8949b955263769016eca5924f2fa5976c581 Mon Sep 17 00:00:00 2001 From: Eric Paulsen Date: Tue, 21 Sep 2021 10:50:20 -0500 Subject: [PATCH 3/4] add github issue --- setup/installation.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/setup/installation.md b/setup/installation.md index eb52a44ba..5ea5777cb 100644 --- a/setup/installation.md +++ b/setup/installation.md @@ -170,9 +170,11 @@ At this point, you're ready to proceed to [configuring Coder](configuration.md). ## EKS Troubleshooting If you're unable to access your Coder deployment via the external IP generated -by EKS, this is likely due to Load Balancer health checks failing. To resolve -this issue, set the `externalTrafficPolicy` helm value to `Cluster` by running -the following command: +by EKS, this is likely due to Load Balancer health checks failing. See the +related [GitHub +issue](https://github.com/kubernetes/kubernetes/issues/80897#issuecomment-567911824). +To resolve this issue, set the `externalTrafficPolicy` Helm value to `Cluster` +by running the following command: ```console helm upgrade --install coder coder/coder --set coderd.serviceSpec.externalTrafficPolicy=Cluster From ed8dfe89c9ec025654fd9b9518e87a3279d4097f Mon Sep 17 00:00:00 2001 From: Eric Paulsen Date: Tue, 21 Sep 2021 15:30:40 -0500 Subject: [PATCH 4/4] wording --- setup/installation.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/setup/installation.md b/setup/installation.md index 5ea5777cb..4ec7ceb99 100644 --- a/setup/installation.md +++ b/setup/installation.md @@ -172,8 +172,9 @@ At this point, you're ready to proceed to [configuring Coder](configuration.md). If you're unable to access your Coder deployment via the external IP generated by EKS, this is likely due to Load Balancer health checks failing. See the related [GitHub -issue](https://github.com/kubernetes/kubernetes/issues/80897#issuecomment-567911824). -To resolve this issue, set the `externalTrafficPolicy` Helm value to `Cluster` +issue](https://github.com/kubernetes/kubernetes/issues/80897#issuecomment-567911824) +for more information. +To resolve this, set the `externalTrafficPolicy` Helm value to `Cluster` by running the following command: ```console