Работа по SSH

Перед началом

1. Команды зависят от терминала. Команда cat работает в macOS, Linux и Git Bash, но не в cmd.exe.
2. Для новых ключей рекомендуется алгоритм ed25519. Если он не поддерживается старой системой, используйте rsa.

Проверка существующих SSH-ключей

Перед созданием нового ключа проверьте, есть ли у вас уже каталог .ssh и готовая пара ключей.

ls -al ~/.ssh

dir %USERPROFILE%\.ssh

Get-ChildItem $env:USERPROFILE\.ssh

Если в списке уже есть файлы id_ed25519 и id_ed25519.pub или id_rsa и id_rsa.pub, можно использовать существующий ключ и перейти к следующему разделу.

Создание нового SSH-ключа

Рекомендуемая команда для всех ОС:

ssh-keygen -t ed25519 -C "your_email@example.com"

Если ed25519 не поддерживается вашей системой, используйте RSA:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

где:

• ssh-keygen — программа для генерации SSH-ключей;
• -t ed25519 — тип ключа;
• -b 4096 — длина RSA-ключа;
• -C "your_email@example.com" — комментарий к ключу, обычно указывают email.

1. Откройте терминал и выполните команду создания ключа.

2. Когда появится запрос Enter file in which to save the key, нажмите Enter, чтобы сохранить ключ в стандартный путь:

   • C:\Users\<your_username>\.ssh\id_ed25519 в Windows;
   • /Users/<your_username>/.ssh/id_ed25519 в macOS;
   • /home/<your_username>/.ssh/id_ed25519 в Linux.

   Если вы хотите отдельный ключ только для GitVerse, можно указать свое имя файла, например gitverse_ed25519. Тогда в следующих командах замените имя файла на свое.

   Если в этом месте система сообщает, что файл уже существует, не перезаписывайте старый ключ без необходимости. Лучше укажите новое имя файла.

3. Когда появится запрос Enter passphrase, введите кодовую фразу или дважды нажмите Enter, если не хотите ее задавать.

4. После генерации у вас появятся два файла:

   • закрытый ключ: id_ed25519;
   • открытый ключ: id_ed25519.pub.

Где обычно лежат SSH-ключи

• в Windows: C:\Users\<your_username>\.ssh;
• в macOS: /Users/<your_username>/.ssh;
• в Linux: /home/<your_username>/.ssh.

Копирование открытого SSH-ключа

Для добавления ключа в GitVerse нужно скопировать содержимое файла .pub.

cat ~/.ssh/id_ed25519.pub

type %USERPROFILE%\.ssh\id_ed25519.pub

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

Если вы создали ключ с другим именем, замените id_ed25519.pub на имя своего файла.

Добавление SSH-ключа в настройках учетной записи

1. Скопируйте содержимое открытого ключа.

2. Перейдите на GitVerse.

3. Нажмите на иконку профиля, затем Настройки.

4. На вкладке Ключи SSH/GPG нажмите Добавить SSH ключ.

5. Введите произвольное название ключа и вставьте содержимое открытого ключа.

6. Нажмите Добавить.

Подключение локального репозитория по SSH

Если репозиторий уже подключен по HTTPS, замените URL удаленного репозитория:

git remote set-url origin git@gitverse.ru:<username>/<repository_name>.git

Проверьте, что URL обновился:

git remote -v

Если вы не хотите заменять HTTPS-адрес, можно добавить SSH как дополнительный URL:

git remote set-url --add origin git@gitverse.ru:<username>/<repository_name>.git

После этого Git сможет хранить для origin несколько URL. Подробности по синтаксису команды git remote set-url --add приведены в официальной документации Git.