English

Подключение системы контроля версий¶

Для добавления в систему проектов (Git репозиториев) на анализ необходимо предварительно создать подключение к системе контроля версий (VCS). CodeScoring поддерживает следующие платформы:

GitLab
GitHub
BitBucket (только Data Center и Server)
Azure DevOps Git
GitFlic
Другие платформы, использующие Git

Интеграция происходит через два возможных механизма: Personal Access Token или ключ SSH. Для механизма Personal Access Token возможно подключение нескольких систем контроля версий с одним адресом, но разными токенами.

После подключения системы контроля версий невозможно поменять ее тип (Instance type) и адрес (Instance URL).

Примечание: в случае, если для обращения к системе контроля версий используются приватные NS сервера, их надо указать в настройках инсталляции. Для получения соответствующих шаблонов необходимо обратиться к вендору.

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

Скопировать существующий или сгенерировать новый приватный SSH ключ в системе контроля версий по инструкции для:
В интерфейсе CodeScoring перейти в раздел Settings -> SSH Keys
Нажать Setup new в правом верхнем углу.
Заполнить форму. Приватный SSH ключ вставляется в поле Instance private key.
Перейти в раздел Settings -> VCS.
Нажать Setup new в правом верхнем углу.
Заполнить форму, как показано на скриншоте. SSH ключ выбирается из списка в поле SSH key.
Проверить подключение можно по кнопке Test it. Для создания подключения необходимо нажать на кнопку Setup now.

Добавление токена для GitLab¶

Оригинальная инструкция для генерации токена на английском: https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token

Войти в свой аккаунт в GitLab, для облачной версии логин доступен по ссылке https://gitlab.com/users/sign_in.
Через меню пользователя в правом верхнем углу перейти в раздел Edit profile.
Далее в левом меню выбрать раздел Access Tokens.
Задать название токену, например, "codescoring-demo", дату можно оставить пустой
В секции scopes выбрать read_api и read_repository.
Нажать кнопку Create personal access token.
Скопировать сгенерированный токен.
В интерфейсе CodeScoring перейти в раздел Settings -> VCS.
Нажать Setup new в правом верхнем углу.
Заполнить форму, как показано на скриншоте. Токен вставляется в поле Access token.

Добавление токена для GitHub¶

Оригинальная инструкция для генерации токена на английском: https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token

Войти в свой аккаунт в GitHub, для облачной версии логин доступен по ссылке https://github.com/login.
Если у аккаунта не верифицирован email, обязательно это сделать по инструкции.
Через меню пользователя в правом верхнем углу перейти в раздел Settings.
Далее в левом меню выбрать раздел Developer settings.
В левом меню выбрать раздел Personal access tokens.
Задать название токену, например, "codescoring-demo".
В секции Select scopes выбрать все опции списка repos.
Нажать кнопку Generate token.
Скопировать сгенерированный токен.
В интерфейсе CodeScoring перейти в раздел Settings -> VCS.
Нажать Setup new в правом верхнем углу.
Заполнить форму, как показано на скриншоте. Токен вставляется в поле Access token.

Добавление токена для BitBucket Data Center и Server¶

Оригинальная инструкция для генерации токена на английском: https://confluence.atlassian.com/bitbucketserver072/personal-access-tokens-1005335924.html

Войти в свой аккаунт в BitBucket.
Через меню пользователя в правом верхнем углу перейти в раздел Manage account.
Далее в левом меню выбрать раздел Personal access tokens.
Нажать на Create token.
Задать название токену, например, "codescoring-demo".
В секции Permissions дать права на чтение для проектов и репозиториев.
В секции Expiry при желании задать срок жизни токена.
Нажать кнопку Create.
Скопировать сгенерированный токен.
В интерфейсе CodeScoring перейти в раздел Settings -> VCS.
Нажать Setup new в правом верхнем углу.
Заполнить форму, как показано на скриншоте. Токен вставляется в поле Access token.

Добавление токена для Azure DevOps Git¶

Оригинальная инструкция для генерации токена на английском: https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops

Войти в свой аккаунт в Azure DevOps.
Через меню пользователя в правом верхнем углу перейти в раздел Personal access tokens.
Далее нажать кнопку New token.
Задать название токену, например, "codescoring-demo", и срок действия токена.
В секции Scopes обязательно отметить доступ на Read для сущностей Code и Identity.
Нажать кнопку Create.
Скопировать сгенерированный токен.
В интерфейсе CodeScoring перейти в раздел Settings -> VCS.
Нажать Setup new в правом верхнем углу.
Заполнить форму, как показано на скриншоте. Токен вставляется в поле Access token.

Подключение GitFlic через ssh¶

Создайте новую пару ключей ssh без passphase с типом RSA_SHA512,SSH_ED25519 или ECDSA-SHA2-nistp256.
```
ssh-keygen -t ed25519 -N "" -q -f /tmp/id25519
```
Перейдите в веб-интерфейс GitFlic в раздел Настройки -> Ключи и добавьте публичный ключ в пул ключей GitFlic.

Посмотреть содержимое публичного ключа можно при помощи следующей команды:
```
cat /tmp/id25519.pub
```
Перейдите в интерфейс CodeScoring в раздел Settings -> SSH Keys, откройте форму добавления ключа по кнопке Setup New и добавьте приватный ключ в пул ключей CodeScoring.

Посмотреть содержимое приватного ключа можно при помощи следующей команды:
```
cat /tmp/id25519
```
Перейдите в раздел Settings -> VCS, откройте форму добавления VCS по кнопке Setup New и заполните поля создания VCS инстанса:
- Instance name – название VCS подключения;
- Instance clone type – тип клонирования (выбрать тип SSH);
- Instance type – тип инстанса VCS (выбрать тип Other git);
- Instance url – адрес, по которому доступен VCS;
- SSH key – ключ SSH, созданный в пункте 4.
Перейдите в раздел Settings -> Project, откройте форму создания нового проекта по кнопке Create New и заполните поля создания проекта:
- Repository – ссылка на репозиторий в GitFlic;
- VCS – название инстанса VCS, созданного в пункте 6.
Важно: ввиду особенностей работы GitFlic и CodeScoring, стандартную ссылку на репозиторий необходимо модифицировать, убрав из нее часть пути /project/. Например:
```
<https://gitflic.ru/project/kovalevaa/utils.git> -> <https://gitflic.ru/kovalevaa/utils.git>_
```
Сохраните проект.