From ce40a1b13af326fdb04b68c5262c29d80805dfef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Harper?= Date: Mon, 2 Oct 2023 16:58:54 -0400 Subject: [PATCH] fix: add information on SSH key unknown errors (fix #237) (#503) --- docs/common/partials/github/_tokens.mdx | 4 ++++ docs/common/partials/gitlab/_tokens.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/common/partials/github/_tokens.mdx b/docs/common/partials/github/_tokens.mdx index 8da81065..303c0897 100644 --- a/docs/common/partials/github/_tokens.mdx +++ b/docs/common/partials/github/_tokens.mdx @@ -12,3 +12,7 @@ kubefirst uses the following scopes to provision the kubefirst platform: There are different ways to create a GitHub token. The easiest way is to start the kubefirst installer, and follow the screen instructions. It will guide you to issue a token with the list of scope described above. There are other ways to create a GitHub token. You can login into your GitHub account and issue a Personal Access token following the list of scopes above. With the manually generated token, you can provide it via environment variable: `export GITHUB_TOKEN`. + +:::tip +If you never connected to GitHub using SSH before, be sure to add it to the known host using the command `ssh-keyscan github.com >> ~/.ssh/known_hosts` to ensure you won't get a `ssh: handshake failed: knownhosts: key is unknown` error. +::: diff --git a/docs/common/partials/gitlab/_tokens.mdx b/docs/common/partials/gitlab/_tokens.mdx index 4d2c73e6..2d274fe2 100644 --- a/docs/common/partials/gitlab/_tokens.mdx +++ b/docs/common/partials/gitlab/_tokens.mdx @@ -13,3 +13,7 @@ kubefirst uses the following scopes to provision the kubefirst platform: There are different ways to create a GitLab token. The easiest way is to start the kubefirst installer, and follow the screen instructions. It will guide you to issue a token with the list of scope described above. There are other ways to create a GitLab token. You can login into your GitLab account and issue a Personal Access Token following the list of scopes above. With the manually generated token, you can provide it via environment variable: `export GITLAB_TOKEN`. + +:::tip +If you never connected to GitLab using SSH before, be sure to add it to the known host using the command `ssh-keyscan gitlab.com >> ~/.ssh/known_hosts` to ensure you won't get a `ssh: handshake failed: knownhosts: key is unknown` error. +:::