Skip to content

add EKS troubleshooting steps #622

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Sep 21, 2021
Merged

add EKS troubleshooting steps #622

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9d9fc07
add EKS troubleshooting steps
ericpaulsen Sep 20, 2021
b238aec
let's try that again
ericpaulsen Sep 20, 2021
f58e894
add github issue
ericpaulsen Sep 21, 2021
ed8dfe8
wording
ericpaulsen Sep 21, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion setup/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -166,3 +166,21 @@ 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. See the
related [GitHub
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
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).