From 9f5d87d80606acc35148c23e9ddf86adf941bda8 Mon Sep 17 00:00:00 2001 From: Filip Aleksic Date: Fri, 31 Mar 2023 07:51:29 +0000 Subject: [PATCH 1/5] Host SSH key changes --- doc/user/project/repository/mirror/index.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/user/project/repository/mirror/index.md b/doc/user/project/repository/mirror/index.md index 32183eccc2fda6..c5e31f9237f78c 100644 --- a/doc/user/project/repository/mirror/index.md +++ b/doc/user/project/repository/mirror/index.md @@ -330,6 +330,19 @@ and requires the full version including the protocol (`ssh://git@gitlab.com/gitl Make sure that host and project path are separated using `/` instead of `:`. +### Host key verification failed + +This error is returned when the target host public SSH key changes. +Normally public SSH keys do not change over time, or they get updated very rarely. To resolve the issue: + +1. [Verify the host key](#verify-a-host-key) +1. On the top bar, select Main menu > Projects and find your project. +1. On the left sidebar, select Settings > Repository. +1. Expand Mirroring repositories. +1. Refresh the keys by either clicking on: + - "Detect host keys" where GitLab fetches the host keys from the server and displays the fingerprints OR + - "Input host keys manually" and entering the host key(s) into the **SSH host key** field. + ### Transfer mirror users and tokens to a single service account in Rails console This requires access to the [GitLab Rails console](../../../../administration/operations/rails_console.md#starting-a-rails-console-session). -- GitLab From e4f4e1fb27f9d8effa015f643f89aff2bd1d0719 Mon Sep 17 00:00:00 2001 From: Filip Aleksic Date: Fri, 31 Mar 2023 10:08:30 +0200 Subject: [PATCH 2/5] Linting fixes --- doc/user/project/repository/mirror/index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/user/project/repository/mirror/index.md b/doc/user/project/repository/mirror/index.md index c5e31f9237f78c..9fce31b073259a 100644 --- a/doc/user/project/repository/mirror/index.md +++ b/doc/user/project/repository/mirror/index.md @@ -333,15 +333,16 @@ Make sure that host and project path are separated using `/` instead of `:`. ### Host key verification failed This error is returned when the target host public SSH key changes. -Normally public SSH keys do not change over time, or they get updated very rarely. To resolve the issue: +Typically public SSH keys do not change over time, or they get updated very rarely. To resolve the issue: 1. [Verify the host key](#verify-a-host-key) 1. On the top bar, select Main menu > Projects and find your project. 1. On the left sidebar, select Settings > Repository. 1. Expand Mirroring repositories. 1. Refresh the keys by either clicking on: - - "Detect host keys" where GitLab fetches the host keys from the server and displays the fingerprints OR - - "Input host keys manually" and entering the host key(s) into the **SSH host key** field. + +- "Detect host keys" where GitLab fetches the host keys from the server and displays the fingerprints OR +- "Input host keys manually" and entering the host keys into the **SSH host key** field. ### Transfer mirror users and tokens to a single service account in Rails console -- GitLab From 57354c98f694d123b4ad1c012213143df060b22c Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Mon, 3 Apr 2023 07:18:09 +0000 Subject: [PATCH 3/5] Apply 1 suggestion(s) to 1 file(s) --- doc/user/project/repository/mirror/index.md | 23 ++++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/doc/user/project/repository/mirror/index.md b/doc/user/project/repository/mirror/index.md index 9fce31b073259a..8ade4ad3e6d193 100644 --- a/doc/user/project/repository/mirror/index.md +++ b/doc/user/project/repository/mirror/index.md @@ -333,16 +333,23 @@ Make sure that host and project path are separated using `/` instead of `:`. ### Host key verification failed This error is returned when the target host public SSH key changes. -Typically public SSH keys do not change over time, or they get updated very rarely. To resolve the issue: +Public SSH keys rarely, if ever, change. If host key verification fails, +but you suspect the key is still valid, you can refresh the key's information. -1. [Verify the host key](#verify-a-host-key) -1. On the top bar, select Main menu > Projects and find your project. -1. On the left sidebar, select Settings > Repository. -1. Expand Mirroring repositories. -1. Refresh the keys by either clicking on: +Prerequisites: -- "Detect host keys" where GitLab fetches the host keys from the server and displays the fingerprints OR -- "Input host keys manually" and entering the host keys into the **SSH host key** field. +- You must have at least the Maintainer role for a project. + +To resolve the issue: + +1. [Verify the host key](#verify-a-host-key). +1. On the top bar, select **Main menu > Projects** and find your project. +1. On the left sidebar, select **Settings > Repository**. +1. Expand **Mirroring repositories**. +1. To refresh the keys, either: + + - Select **Detect host keys** for GitLab to fetch the host keys from the server, and display the fingerprints. + - Select **Input host keys manually**, and entering the host keys into the **SSH host key** field. ### Transfer mirror users and tokens to a single service account in Rails console -- GitLab From 2a74a94997afc8b79b6a6750cbe19e7d1fbcd435 Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Mon, 3 Apr 2023 19:43:40 +0000 Subject: [PATCH 4/5] Apply last fixes Brings the rest of what's here up to style spec. --- doc/user/project/repository/mirror/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/user/project/repository/mirror/index.md b/doc/user/project/repository/mirror/index.md index 8ade4ad3e6d193..93cb6dbd4eb0f8 100644 --- a/doc/user/project/repository/mirror/index.md +++ b/doc/user/project/repository/mirror/index.md @@ -349,7 +349,8 @@ To resolve the issue: 1. To refresh the keys, either: - Select **Detect host keys** for GitLab to fetch the host keys from the server, and display the fingerprints. - - Select **Input host keys manually**, and entering the host keys into the **SSH host key** field. + - Select **Input host keys manually**, and enter the host key into the **SSH host key** field. +- Select **Mirror repository**. ### Transfer mirror users and tokens to a single service account in Rails console -- GitLab From 9f758e2f19b7451fa2f6c556247b1d6f977dce01 Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Mon, 3 Apr 2023 20:45:16 +0000 Subject: [PATCH 5/5] Apply 1 suggestion(s) to 1 file(s) --- doc/user/project/repository/mirror/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/user/project/repository/mirror/index.md b/doc/user/project/repository/mirror/index.md index 93cb6dbd4eb0f8..61aa2ae33008a4 100644 --- a/doc/user/project/repository/mirror/index.md +++ b/doc/user/project/repository/mirror/index.md @@ -350,6 +350,7 @@ To resolve the issue: - Select **Detect host keys** for GitLab to fetch the host keys from the server, and display the fingerprints. - Select **Input host keys manually**, and enter the host key into the **SSH host key** field. + - Select **Mirror repository**. ### Transfer mirror users and tokens to a single service account in Rails console -- GitLab