Skip to content

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

Интеграция с Gitea позволяет подключать репозитории Gitea к Vampy, импортировать и автоматически связывать их, запускать сканирования через оркестрацию и реагировать на события VCS.

Внимание

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

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

  • импорт и поиск репозиториев Gitea;
  • привязка существующих репозиториев Vampy к репозиториям Gitea;
  • запуск сканирований кода из подключённых репозиториев;
  • определение языков репозитория;
  • реакция на события VCS через webhook: появление нового репозитория и Merge Request.

Ограничения

Для Gitea не поддерживается Git blame (привязка дефектов к авторам строк кода).

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

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

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

  • Имя интеграции — произвольное имя для идентификации;
  • URL — адрес сервера Gitea, например https://gitea.example;
  • API токен — токен доступа Gitea (см. ниже).

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

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

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

Access Token

Для интеграции сгенерируйте Access Token в Gitea: Settings → Applications → Generate New Token.

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

Scope Зачем нужен
read:user проверка токена при сохранении интеграции
read:repository импорт и поиск репозиториев, привязка, определение языков, скачивание архива для оркестрации
read:organization доступ к репозиториям организаций (рекомендуется, если такие репозитории нужно импортировать)

Прав на запись (write) не требуется — Vampy только читает данные из Gitea. Webhook'и доставляются в Vampy и отдельного scope для них не нужно.

Документацию по созданию токена см. в официальной документации Gitea.

Настройка Gitea webhook

Webhook позволяет создавать в правилах реакции на события VCS:

  • Событие VCS repository — появление нового репозитория в Gitea;
  • Событие VCS MR — создание или обновление Merge Request.

Скопируйте URL webhook в списке интеграций Gitea: нажмите значок копирования в колонке Вебхук. Вставьте его при создании webhook в Gitea: Settings → Webhooks → Add Webhook. Включите доставку событий Repository и Pull Request.

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

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