Интеграция с GitFlic

Интеграция с GitFlic позволяет подключать репозитории (проекты) GitFlic к Vampy, импортировать и автоматически связывать их, реагировать на события Merge Request, а также — на поддерживаемых версиях GitFlic — запускать сканирования кода через оркестрацию.

Внимание

Интеграция с GitFlic доступна только в Enterprise версии Vampy.

Возможности интеграции:

импорт и поиск проектов GitFlic;
привязка существующих репозиториев Vampy к проектам GitFlic;
реакция на события Merge Request через webhook (создание MR и пуш в ветку открытого MR);
запуск сканирований кода — только на версиях GitFlic, поддерживающих скачивание архива проекта (см. ниже).

Cloud и self-hosted

GitFlic поддерживается в двух вариантах:

Cloud (gitflic.ru) — API обслуживается на отдельном поддомене api.gitflic.ru. В поле URL достаточно указать https://gitflic.ru/, Vampy сам обратится к нужному API-хосту.
Self-hosted — API доступен по пути <host>/rest-api/. Укажите URL вашего инстанса, например https://gitflic.example/.

Настройка интеграции

Для настройки перейдите в раздел Администратор → Интеграция → GitFlic и нажмите + Интеграции GitFlic.

В окне Настройка интеграции GitFlic укажите:

Имя интеграции — произвольное имя для идентификации;
URL — адрес сервера GitFlic (https://gitflic.ru/ или адрес self-hosted инстанса);
API токен — токен доступа GitFlic (см. ниже).

В блоке Дополнительные опции при необходимости можно указать:

Сертификаты CA — для настройки SSL-соединения;
Игнорировать проверку SSL-сертификата — для самоподписанных сертификатов.

Нажмите Сохранить. Интеграция появится в списке интеграций GitFlic.

Access Token

Сгенерируйте Access Token в настройках GitFlic (профиль пользователя → токены доступа).

Минимальный набор прав (scope) для работы с Vampy:

Scope	Зачем нужен
`user_read`	проверка токена при сохранении интеграции
`project_read`	импорт и поиск проектов, привязка репозиториев, Merge Request, скачивание архива для оркестрации
`team_read`	доступ к проектам, принадлежащим командам

Документацию по API см. в документации GitFlic.

Ограничения функциональности

Часть возможностей зависит от версии GitFlic. Если они недоступны, Vampy показывает предупреждение в настройках интеграции:

Сканирование репозитория — запуск оркестрации требует скачивания архива проекта, который есть только на новых версиях GitFlic. Vampy автоматически определяет наличие этой возможности у вашего инстанса.
Git blame — не поддерживается.
Изменения репозитория через правила — событие появления нового репозитория (Событие VCS repository) не поддерживается; через webhook доступны только события Merge Request.

Привязка репозитория к GitFlic

Если репозиторий в Vampy уже создан и его нужно связать с проектом GitFlic, это можно сделать в карточке репозитория или через меню добавления репозитория. Подробнее — в разделе про создание репозиториев.