Skip to content

GitLab

Last edited by Данила Козлов
Page history
This is an old version of this page. You can view the most recent version or browse the history.

create ssh key

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

С помощью OpenSSH

  1. Воспользоваться утилитой "ssh-keygen.exe" из поставки Git:
C:\Program Files (x86)\Git\bin\ssh-keygen -t rsa -C USERNAME@DOMAIN.TLD

где USERNAME@DOMAIN.TLD необходимо заменить на ваш email, например v.pupkin@isimplelab.com

На запрос Passphrase нажать Enter. Задавать passphrase нет необходимости, в противном случае система будет требовать её при каждом обращении к удалённому репозиторию.

В случае использования ОС Windows:

  • при запуске утилиты через Far Manager или командную строку, необходимо запустить их из под Администратора
  • если в переменных окружения указать переменную HOME, то по умолчанию ключ будет сгенерен в %HOME%\.ssh\id_rsa
  1. Полученные ключи разместить в %USERPROFILE%\.ssh. Имена файлов с ключами должны быть:
  • id_rsa - приватный ключ
  • id_rsa.pub - публичный ключ
  1. Создать файл %USERPROFILE%\.ssh\config в котором прописать:
Host source.isimplelab.com
Port 222

С помощью PuTTY (только для пользователей Windows)

  1. Скачать и установить [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY]

  2. Воспользоваться утилитой puttygen для генерации ключа. Комментарий к ключу (Key comment) - email пользователя, который указан в GitLab (USERNAME@DOMAIN.TLD).

  3. Скопировать значение публичного ключа, для последующего указания его в настройках профайла Git Lab. Секретный ключ сохранить в удобную дирекорию - файл с данным ключом должен иметь расширение *.ppk.

  4. Создать системную переменную GIT_SSH, прописать в ней путь к утилите plink.exe входящей в состав PuTTY. Например, GIT_SSH=C:\PuTTY\plink.exe. Если msysgit для Windows ставится после Putty, то в процессе установки можно выбрать использование PuTTY в качестве ssh агента - тогда эта переменная будет уже прописана.

  5. Запусть pagent.exe входящий в состав PuTTY и добавить в него сохраненный секретный ключ (файл с расширением *.ppk). При добавлении ключа, pagent.exe попросит ввести пароль от ключа (passphrase). Для того чтобы при перезапуске системы, ключ добавлялся автоматически - необходимо создать ярлык для pagent.exe передав в качестве параметра путь к ключу, например, путь в ярлыке будет следующего вида: "C:\PuTTY\pagent.exe C:\keys\private_key.ppk". Созданный ярлык добавить в Автозапуск.

  6. В пути создать и сохранить сессию подключения к хосту GitLab. Host: source.isimplelab.com Port: 222, во вкладке Connection/SSH/Auth выбрать соответствующий ppk ключ и выбрать параметр "Allow agent forwarding". Сессию сохранить под именем source.isimplelab.com.

  7. Выполнить подключение через созданную сессию, в качестве имени пользователя указать "git", сервер должен ответить "Welcome to GitLab %USERNAME%". Данный шаг, необходим, чтобы plink добавил source.isimplelab.com в список доверенных хостов.

Добавление SSH-ключа:

  1. Заходите в GitLab.
  2. Щёлкаете по значку со всплывающей подсказкой "Profile settings".
  3. На странице профиля выбираете группу настроек "SSH Keys".
  4. Нажимаете на кнопку "Add SSH Key".
  5. В поле "Title" вводите любой заголовок.
  6. В поле "Key" копируете содержимое файла "id_rsa.pub" (в случае использования PuTTY значение скопированное на шаге 3).
  7. Нажимаете на кнопку "Add key".