Работа с ревью

Как работает ревью

Один раз на merge request

Автоматическое ревью выполняется один раз на merge request — на первом пайплайне, который до него дошёл. Следующие пуши в тот же MR ревью не запускают: повторный прогон по всему диффу заново нашёл бы те же замечания на неизменившихся строках, и к пятому пушу в MR было бы пять одинаковых комментариев. Job на таких пушах завершается сразу, с кодом 0.

Что появляется в merge request

  • Инлайн-замечания — на добавленных или изменённых строках. Замечания на нетронутом коде в обсуждения не ставятся: ревьюеры их устойчиво отклоняют как выход за рамки задачи.
  • Сводный комментарий — вердикт, итоги и замечания, которые не удалось привязать к строке. Он один на MR: при повторе ревью обновляется или получает ответ в своём обсуждении, а не дублируется.
  • Готовая замена кода (suggestion) — у части замечаний. Читайте её так же внимательно, как код коллеги, прежде чем применить.

Итоги видны и в панели: лента ревью проекта, статусы замечаний, расход тарифа.

Повтор ревью — /review

Нужно ревью после существенных правок — оставьте в MR комментарий /review и запушьте изменения (или перезапустите job). Runner увидит команду после своего последнего сводного комментария и выполнит ревью ещё раз.

Чья команда засчитывается, зависит от платформы:

Платформа Кто может запустить повтор
GitLab Участник с правом записи в репозиторий
GitFlic Участник с правом записи — если у токена бота роль Administrator; иначе только автор MR
GitVerse Только автор MR

Команды от владельца токена Runner считает своими и не учитывает — поэтому для бота нужна отдельная учётная запись.

Что не тарифицируется

Запуски, не дошедшие до модели: отфильтрованные условиями запуска, MR с меткой-исключением, повторные пуши без /review. Тарифицируется ревью, которое отправило запрос модели и опубликовало результат.