Для чего нужен раздел
Подключите Git-провайдера с помощью токена и выберите репозитории для анализа. После сохранения запустите первую синхронизацию из карточки подключения. Само сохранение её не запускает; фоновое обновление зависит от настроенного расписания.
Когда использовать
- При первом подключении репозитория.
- Когда в аналитике нет данных или они перестали обновляться.
- Когда нужно заменить токен или изменить список репозиториев.
Первые шаги
- 1Выпустите токен с нужными правами: repo и read:user для GitHub, read_api и read_user для GitLab.
- 2Для Bitbucket используйте API-токен с базовой авторизацией: почта Atlassian в поле email и токен ниже. OAuth-токены — это другой режим, они не взаимозаменяемы.
- 3Для self-hosted укажите URL сервера; пустое поле означает публичный адрес.
- 4Сохраните подключение, включите нужные репозитории, запустите первую синхронизацию и проверьте время её завершения.
Настройки
| Настройка | Что делает | Как настроить | Типичная ошибка |
|---|---|---|---|
| Персональный токен | Аутентифицирует запросы к провайдеру от вашего имени. | Следуйте подсказкам по правам для выбранного провайдера. Если доступ оформлен на служебную учётную запись, проверьте, кто отвечает за её токен. | Ожидать, что токен только для чтения сможет отправлять комментарии или выполнять другие действия автоматизации. Для них нужны отдельные права. |
| URL сервера | Направляет подключение на self-hosted-инстанс вместо публичного. | Укажите полный адрес сервера с https://. Проверьте, что это адрес вашей установки Git-провайдера. | Указать адрес отдельного репозитория или страницы API вместо адреса сервера. |
| Включённые репозитории | Выбирают, что именно анализируется. | Начните с одного активного репозитория команды. После проверки данных добавьте остальные нужные репозитории. | Включить архивы и сторонний код, а затем принять их историю за текущую работу команды. |
Пример использования
Ситуация: В обзоре команды несколько дней не появляются новые данные.
- 1Откройте эту страницу и посмотрите время последней синхронизации у каждого подключения.
- 2Запустите синхронизацию вручную и проверьте статус завершения.
- 3При ошибке проверьте срок действия токена, его права и доступность сервера. После исправления повторите синхронизацию.
Что станет понятно: Вы проверили состояние подключения и можете отличить ошибку синхронизации от периода без новых изменений.
Частые вопросы
Вы читаете наш исходный код?
Для аналитики читаются метаданные коммитов, пулл-реквестов и ревью. Для определения технологий также используются дерево файлов и выбранные файлы зависимостей и конфигурации, например package.json, go.mod и Dockerfile. Полная копия исходного кода не загружается. Токены хранятся в зашифрованном виде.
Как часто идёт синхронизация?
Git-интеграции обновляются автоматически, по умолчанию примерно раз в полчаса, и в любой момент синхронизацию можно запустить вручную.
Что произойдёт, если удалить подключение?
Синхронизация остановится. В Commitlane будут удалены подключение, связанные синхронизированные репозитории и их записи коммитов и пулл-реквестов. Исходные репозитории у Git-провайдера не изменятся. Для сохранения доступа с новым токеном обновите подключение вместо его удаления.
Практические советы
- Запишите срок действия токена и замените его до истечения. При устаревших данных сначала проверьте статус синхронизации.
- После подключения одного репозитория сверьте его данные с Git-провайдером, затем добавляйте остальные.