Разделы документации
Коннекторы
GitHub
Подключение GitHub к Charo — токен доступа, выбор репозиториев, pull-реквесты и задачи.
Что индексируется
- Pull-реквесты и задачи (issues) выбранных репозиториев — включая описания и обсуждения.
Работает и с github.com, и с GitHub Enterprise Server.
Предварительные требования
- Токен GitHub с доступом на чтение нужных репозиториев.
Получение учётных данных
- На GitHub откройте Settings → Developer settings → Personal access
tokens и создайте токен: fine-grained с правами чтения Issues и Pull
requests нужных репозиториев, либо классический со scope
repo(для приватных) илиpublic_repo(для публичных). - В Charo укажите его в поле «Токен доступа GitHub».
Настройка в Charo
| Поле | Что указать |
|---|---|
| Владелец репозитория | имя пользователя или организации GitHub |
| Что индексировать из GitHub? | «Всё» — все доступные репозитории владельца; либо конкретные «Название(я) репозиториев» — через запятую (например, repo1,repo2,repo3) |
| Включать pull-реквесты? | индексировать pull-реквесты из репозиториев |
| Включать задачи? | индексировать задачи из репозиториев |
Синхронизация прав
Поддерживается: приватные репозитории увидят в поиске только те, у кого есть к ним доступ на GitHub. Требуется активная лицензия; подробнее — «Права доступа».
Ограничения и частота обновления
- Скорость ограничена лимитами GitHub API (5000 запросов/час на токен); большие организации индексируются постепенно.
- Обновления забираются инкрементально по расписанию коннектора.
Устранение неполадок
«401 Bad credentials»
Токен истёк или отозван — выпустите новый.
«404 Not Found» на приватном репозитории
Fine-grained токен не выдан на этот репозиторий, либо классическому токену не
хватает scope repo.
Индексация медленная
Упёрлись в лимит API — это нормально: коннектор дождётся сброса квоты и продолжит.