Для чего нужен раздел
В разделе можно создать политику, проверить её на конкретном пулл-реквесте и посмотреть результат запуска. Текущая форма создаёт черновик с добавлением комментария по ручному запуску. Отдельная форма задаёт ревьюеров для выбранных путей файлов. Политики и правила, созданные другими способами, могут содержать дополнительные настройки; редактирование основных полей их сохраняет.
Когда использовать
- Когда один и тот же комментарий нужно добавлять к разным пулл-реквестам.
- Когда для определённых частей кода нужно задать список ревьюеров.
- Когда нужно проверить, почему действие выполнилось, было пропущено или завершилось ошибкой.
Первые шаги
- 1Создайте политику: укажите название, репозитории и текст комментария. Оставьте пробный режим включённым.
- 2Откройте запуск политики, укажите полное имя репозитория и номер пулл-реквеста. Сначала выполните пробный запуск.
- 3Посмотрите результат и условия в истории запусков. Пробный запуск не меняет пулл-реквест.
- 4Чтобы отправить комментарий, выключите пробный режим и в политике, и в форме запуска. Затем запустите действие вручную и проверьте результат у Git-провайдера.
Настройки
| Настройка | Что делает | Как настроить | Типичная ошибка |
|---|---|---|---|
| Пробный режим | Показывает, что сделала бы политика, без изменения пулл-реквеста. | Проверьте результат на конкретном пулл-реквесте перед реальным запуском. | Выключить пробный режим только в форме запуска, оставив его включённым в политике. |
| Репозитории и комментарий | Ограничивает репозитории для новой политики и задаёт текст отправляемого комментария. | Начните с одного репозитория и проверьте текст до сохранения. Новая политика не добавляет повторно такой же комментарий. | Ожидать, что сохранение черновика само запустит действие при открытии пулл-реквеста. |
| Правило выбора ревьюеров | Задаёт пути файлов, логины ревьюеров и число назначений. | Укажите ревьюеров, знакомых с этими файлами. Новое правило неактивно; проверьте его перед включением. Автор изменения исключается из выбора. | Ввести имена вместо логинов Git-провайдера или ожидать выбора по нагрузке от формы с конкретным списком людей. |
Пример использования
Ситуация: К пулл-реквестам в одном репозитории нужно добавлять напоминание проверить миграцию.
- 1Создайте политику с нужным репозиторием и текстом напоминания.
- 2Укажите номер тестового пулл-реквеста и выполните пробный запуск. Проверьте результат в истории.
- 3Для реального запуска отключите пробный режим в обоих местах и запустите политику. Убедитесь, что комментарий появился в пулл-реквесте.
Что станет понятно: Вы проверили политику на конкретном изменении и можете повторять ручной запуск для других подходящих пулл-реквестов.
Частые вопросы
Что означает пропущенный запуск?
Не выполнилось условие политики или действие не требовалось, например такой комментарий уже есть. Откройте результат запуска: пропуск и ошибка показываются отдельно.
Почему после открытия пулл-реквеста ничего не произошло?
Новая политика из этой формы запускается вручную. Откройте запуск, укажите репозиторий и номер пулл-реквеста. Сохранение политики само по себе не включает запуск по событиям.
Почему реальный запуск остался пробным?
Пробный режим включается, если он отмечен хотя бы в одном месте: в самой политике или в форме запуска. Для реального действия нужно снять обе отметки. Токен подключения также должен иметь права на нужное действие.
Практические советы
- Раздел находится в бете. Проверяйте результаты пробного запуска и историю ошибок перед использованием на важных репозиториях.
- При редактировании существующей политики её действия и условия сохраняются. Проверьте их перед запуском: они могут отличаться от комментария, создаваемого новой формой.