From 9e116b4fde96e445eb6ce5859d4d347df150dd91 Mon Sep 17 00:00:00 2001 From: Eric Paulsen Date: Thu, 12 Aug 2021 11:36:26 -0500 Subject: [PATCH 1/2] add admin pwd reset troubleshooting & manifest updates --- guides/troubleshooting/admin-pwd.md | 26 +++++++++++++++++++ guides/troubleshooting/docker-problems.md | 3 +++ guides/troubleshooting/git-oauth.md | 3 +++ .../troubleshooting/inotify-watch-limits.md | 3 +++ manifest.json | 6 +++++ 5 files changed, 41 insertions(+) create mode 100644 guides/troubleshooting/admin-pwd.md diff --git a/guides/troubleshooting/admin-pwd.md b/guides/troubleshooting/admin-pwd.md new file mode 100644 index 000000000..2843b23f0 --- /dev/null +++ b/guides/troubleshooting/admin-pwd.md @@ -0,0 +1,26 @@ +--- +title: Resetting admin password +description: Learn how to resolve errors resetting your admin password +--- + +When attempting to reset your Coder admin password in the terminal, you may +encounter the following error: + +```console +error: unable to upgrade connection: error dialing backend: remote error: tls: +handshake failure +``` + +## Why this happens + +This upgrade error can occur when a proxy is in front of the `kube-apiserver`, +which blocks your attempt to reach the `coderd` pod and reset the admin +password. + +## Troubleshooting steps + +To properly access to the `coderd` pod, you'll need to either remove the proxy +(if possible), or circumvent the proxy and make the call directly with `kubectl`. + +If this doesn't resolve the issue, please +[contact us](https://coder.com/contact) for further support. diff --git a/guides/troubleshooting/docker-problems.md b/guides/troubleshooting/docker-problems.md index 1a60a1017..a53b52532 100644 --- a/guides/troubleshooting/docker-problems.md +++ b/guides/troubleshooting/docker-problems.md @@ -113,3 +113,6 @@ daemonset.apps "increase-limits" deleted However, note that the setting will persist until the node restarts or another program sets the `kernel.keys.maxkeys` and `kernel.keys.maxkeys` settings. + +If this doesn't resolve the issue, please +[contact us](https://coder.com/contact) for further support. diff --git a/guides/troubleshooting/git-oauth.md b/guides/troubleshooting/git-oauth.md index 0cfd5902f..73934ec71 100644 --- a/guides/troubleshooting/git-oauth.md +++ b/guides/troubleshooting/git-oauth.md @@ -32,3 +32,6 @@ attempts to add your public key again to GitHub. If the steps above do not fix the problem, the error may be related to the GitHub configuration values set using Coder's **Admin** panel. Site managers can view and update these values at **Manage** > **Admin** > **Git OAuth**. + +If this doesn't resolve the issue, please +[contact us](https://coder.com/contact) for further support. diff --git a/guides/troubleshooting/inotify-watch-limits.md b/guides/troubleshooting/inotify-watch-limits.md index d29d587bc..54f8c5d84 100644 --- a/guides/troubleshooting/inotify-watch-limits.md +++ b/guides/troubleshooting/inotify-watch-limits.md @@ -268,3 +268,6 @@ program sets the `fs.inotify.max_user_watches` setting. - [My ultimate VSCode configuration](https://dev.to/vaidhyanathan93/ulitmate-vscode-configuration-4i2o), a blog post describing a user's preferred settings, including file exclusions + +If none of these steps resolve the issue, please +[contact us](https://coder.com/contact) for further support. diff --git a/manifest.json b/manifest.json index 16672a387..dd1fac9a4 100644 --- a/manifest.json +++ b/manifest.json @@ -394,6 +394,12 @@ }, { "path": "./guides/troubleshooting/502error.md" + }, + { + "path": "./guides/troubleshooting/git-oauth.md" + }, + { + "path": "./guides/troubleshooting/admin-pwd.md" } ] } From 3720ad5bb2ac81fe8fbaa710dda0d3d8179765b2 Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Thu, 12 Aug 2021 14:36:34 -0500 Subject: [PATCH 2/2] Edit text; update manifest --- guides/troubleshooting/admin-pwd.md | 18 +++++++++--------- manifest.json | 12 ++++++------ 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/guides/troubleshooting/admin-pwd.md b/guides/troubleshooting/admin-pwd.md index 2843b23f0..2452b5e7f 100644 --- a/guides/troubleshooting/admin-pwd.md +++ b/guides/troubleshooting/admin-pwd.md @@ -1,10 +1,10 @@ --- -title: Resetting admin password -description: Learn how to resolve errors resetting your admin password +title: Admin password reset +description: Learn how to resolve issues with resetting your admin password. --- -When attempting to reset your Coder admin password in the terminal, you may -encounter the following error: +When resetting your Coder admin password in the terminal, you may encounter the +following error: ```console error: unable to upgrade connection: error dialing backend: remote error: tls: @@ -13,14 +13,14 @@ handshake failure ## Why this happens -This upgrade error can occur when a proxy is in front of the `kube-apiserver`, -which blocks your attempt to reach the `coderd` pod and reset the admin -password. +This upgrade-related error occurs when a proxy is in front of `kube-apiserver`, +blocking your attempt to reach the `coderd` pod and reset the admin password. ## Troubleshooting steps -To properly access to the `coderd` pod, you'll need to either remove the proxy -(if possible), or circumvent the proxy and make the call directly with `kubectl`. +To access the `coderd` pod properly, you'll need to remove the proxy. If +removing the proxy isn't possible, circumvent the proxy and make the call to +`coderd` directly using `kubectl`. If this doesn't resolve the issue, please [contact us](https://coder.com/contact) for further support. diff --git a/manifest.json b/manifest.json index dd1fac9a4..8a7fdb4c7 100644 --- a/manifest.json +++ b/manifest.json @@ -384,22 +384,22 @@ "path": "./guides/troubleshooting/index.md", "children": [ { - "path": "./guides/troubleshooting/docker-problems.md" + "path": "./guides/troubleshooting/admin-pwd.md" }, { - "path": "./guides/troubleshooting/registry.md" + "path": "./guides/troubleshooting/docker-problems.md" }, { - "path": "./guides/troubleshooting/inotify-watch-limits.md" + "path": "./guides/troubleshooting/git-oauth.md" }, { - "path": "./guides/troubleshooting/502error.md" + "path": "./guides/troubleshooting/registry.md" }, { - "path": "./guides/troubleshooting/git-oauth.md" + "path": "./guides/troubleshooting/inotify-watch-limits.md" }, { - "path": "./guides/troubleshooting/admin-pwd.md" + "path": "./guides/troubleshooting/502error.md" } ] }