Все материалыIstok ConnectПодключение Git-репозитория
Тимлиды и разработчики, подключающие репозитории команды
7 мин

Подключение Git-репозитория

Как подключить репозиторий в Istok Connect, что происходит после индексации и когда действительно нужен webhook.

connectgitgithubgitlabрепозиторийиндексацияwebhook
Когда читать
  • Хотите добавить код-базу проекта в поиск
  • Настраиваете автоматическое код-ревью
  • Команде нужен единый поиск по документам и коду
Что даст материал
  • Понимание, какие провайдеры поддерживают только индекс, а какие ещё и авто-review через webhook
  • Репозиторий подключен и индексируется без путаницы между ручной синхронизацией и автоматикой
  • Код доступен для поиска, review и аналитики в рамках одного проекта
1

Поддерживаемые провайдеры

В текущей версии Istok Connect умеет подключать репозитории из GitHub, GitLab, Gitea и GitFlic. После подключения код начинает участвовать в поиске и в аналитике внутри того же проекта.

Автоматическая регистрация webhook из интерфейса доступна только для GitHub и GitLab. Gitea и GitFlic можно использовать для индексации и ручного review по diff, но не для встроенного сценария "включить webhook одной кнопкой".

Отдельный случай GitHub AppЕсли репозиторий подключён через GitHub App, чтение и индексация работают как обычно. Для webhook нужна настройка на уровне GitHub App, а не обычная кнопка на карточке репозитория.
2

Процесс подключения

После индексации код становится доступен в чате проекта и в связанных разделах Connect. Если ваша цель только поиск по коду и аналитика, на этом этапе уже можно начинать работу.

Webhook нужен не для самого факта подключения, а для автоматики. Без него репозиторий всё равно можно синхронизировать вручную и отправлять diff на review вручную.

1

Выберите проект

Откройте раздел Connect и выберите проект, в контур которого должен попасть код.

2

Добавьте репозиторий

Подключите GitHub, GitLab, Gitea или GitFlic через доступный для вашего контура способ авторизации.

3

Дождитесь индексации

Система клонирует репозиторий, разберёт поддерживаемые файлы и подготовит код для поиска, review и аналитики.

3

Синхронизация

Ручная синхронизация запускается из карточки репозитория. Она подтягивает изменения и перестраивает индекс без необходимости подключать webhook.

Webhook на push нужен, когда вы хотите обновлять индекс без ручного запуска. Важно не путать это с review: push инициирует синхронизацию, а не создаёт review сам по себе.

Размер репозиторияФайлы свыше 512 КБ и директории вроде node_modules, .git, vendor автоматически пропускаются при индексации.
Продолжение по теме

Связанные материалы из этого и соседних разделов

Весь каталог