Результаты и эксплуатация
Прочитайте результат
Коннектор публикует подтверждённые замечания в обсуждениях MR и добавляет итоговый комментарий. Проверки агента, вывод инструментов и ошибки хуков смотрите в полной истории сессии. Финальный ответ агента остаётся в этой истории и не копируется автоматически в GitLab.
При следующих ревью коннектор может обновлять свои обсуждения, закрывать исправленные замечания и сообщать о повторившихся проблемах. Обсуждения людей и назначения других ревьюеров он сохраняет.
Если во время анализа изменился diff, MR закрыт или бот снят с ревью, коннектор отменяет или отбрасывает устаревшую работу. При изменении diff он также снимает себя с ревью без комментария. Чтобы проверить новую ревизию, назначьте бота снова. Он не публикует старое ревью к изменённому diff. Для новой проверки после завершения или ошибки назначьте бота снова. Неудачный анализ автоматически не повторяется.
Комментарий об ошибке показывает публичное сообщение Orpheus, если оно есть, иначе безопасную формулировку ошибки приложения. Публичный текст может содержать исходную ошибку харнеса. Чтобы исключить его, задайте шаблон без подстановки Reason. В стандартном комментарии нет ссылки на сессию. Для ссылки задайте свой шаблон ошибки.
В состоянии обсуждений различаются замечания, явно закрытые участником, и замечания, устаревшие после push. Если GitLab не указал причину закрытия, наличие автора закрытия позволяет распознать явное решение участника.
Запускайте один экземпляр
На одну инсталляцию GitLab и учётную запись бота должен работать ровно один коннектор. Остановите старый процесс перед запуском нового. Увеличение числа реплик не повышает поддерживаемую параллельность ревью. Настраивайте MAX_CONCURRENT_REVIEWS с учётом ресурсов Orpheus и квот провайдеров.
У коннектора нет HTTP API и endpoint проверки здоровья. Отдельная БД ему не нужна. Следите за состоянием процесса и JSON-логами в stdout. Ошибки конфигурации, запуска и выполнения завершают процесс с кодом 1. Подробность логов задаёт LOG_LEVEL.
При остановке коннектора принятые запуски Orpheus продолжаются. После перезапуска коннектор находит их и продолжает публикацию. Временные ошибки публикации повторяются без нового анализа.
Для обновления примера Compose измените версию образа в .env, затем:
docker compose pull
docker compose stop review
docker compose up -d review
docker compose logs --tail=100 reviewПроверьте проблему
| Симптом | Что проверить |
|---|---|
| Коннектор завершается при старте | JSON-лог ошибки, обязательные настройки подключения, доступность каталога workflows и корректность файлов |
| Назначенный MR не запускается | Доступ бота, назначение ревьюером, открытое состояние MR, интервал опроса и лимит параллельности |
| Сообщение о пропуске в GitLab | Добавьте проект в workflow, перезапустите коннектор и назначьте бота снова |
| Не создаётся сессия | Существование профиля, шаблона и кодов сервисов, ключ API и оба ограничения размера запроса: лимит коннектора и MAX_REQUEST_BYTES Orpheus |
Ошибка before_run | Доступ clone/fetch по HTTPS, необходимые инструменты в песочнице и изменение MR во время подготовки |
| Агент закончил, но результат не опубликован | after_run, логи коннектора и права API GitLab. Одного финального ответа недостаточно для публикации ревью |
| В сообщении об ошибке нет ссылки на сессию | В стандартном комментарии ссылки нет. Для её добавления задайте публичный адрес и собственный notes.fail с подстановкой SessionURL. До создания сессии ссылка пустая |