Bitbucket
Отзыв об архитектуре в pull request
Подключите Bitbucket Cloud через OAuth consumer или токен доступа workspace; ArchPilot комментирует pull request в строках, находки приходят на панель.
Аутентификация: OAuth consumer или токен доступа
Экраны работающей установки
Как подключается
- 01
Подключите
Зарегистрируйте OAuth consumer в настройках workspace или вставьте токен workspace или репозитория.
- 02
Выберите репозитории
Выберите репозитории для ревью.
- 03
Откройте PR
ArchPilot проверяет diff и комментирует.
Что вы получаете
Комментарии в PR
Находка в строке и предлагаемое исправление.
Токены обновляются сами
OAuth-токены живут недолго; AppArch обновляет их перед каждым вызовом, и ревью не падает из-за истёкшего токена.
Находки в панели
Оценка, тренды и детали в одном месте.
Работает в вашем CI
Анализ идёт в ваших Bitbucket Pipelines.
Как это работает внутри AppArch
Ваш сервер AppArch общается с Git-платформой, анализ идёт в вашем CI. Здесь все вызовы в обе стороны.
Что читает
- Репозитории, ветки и участники; участники каждые 10 минут для синхронизации разработчиков
- Merge request, одобрения и обсуждения; данные MR каждые 15 минут для MR Insights
- Защита веток и настройки слияния - для Git Health
- Отдельные файлы и дерево файлов - для модуля соответствия; ничего не клонируется
Что пишет
- Комментарии к строкам, которые добавило изменение
- Раздел AppArch в описании MR или один итоговый комментарий, если правка не удалась
- Закрывает своё обсуждение, когда находка исчезла
- Необязательные автоодобрение и автоотклонение; одобрения нет, если после ревью пришли новые коммиты
- Запускает пользовательские пайплайны apparch-scan и apparch-manual, может читать и писать переменные
Чего никогда не делает
- Никаких статусов коммитов и check run: результат пайплайна - код выхода вашего CI-job
- Никогда не клонирует и не загружает репозиторий в панель
- Сам webhook не регистрирует; вставьте URL, если он нужен
- Только Bitbucket Cloud; Server и Data Center не поддерживаются
- Защита тегов, отслеживание релизов и правила слияния не читаются
OAuth-consumer (account, repository, pullrequest, webhook), чьи примерно двухчасовые токены обновляются сами, или токен доступа пространства или репозитория.
Когда что происходит
- 5 sПубликуются комментарии
- 10 sНовые находки сопоставляются с обсуждениями
- 5 minПеречитываются состояние MR и одобрения
- 10 minСинхронизируются участники
- 15 minДанные MR для MR Insights
Webhook делает изменение состояния MR мгновенным, без ожидания следующего опроса.
Как это выглядит в продукте
Все скриншоты
Подключите Bitbucket
Подключение за минуты - первый разбор придёт уже на следующем изменении.