Сведения о проверках запроса на вытягивание

Проверки позволяют участникам совместной работы комментировать изменения, предложенные в запросах на включение внесенных изменений, утверждать изменения или создавать запросы на дальнейшие изменения до объединения запросов на включение внесенных изменений. Администраторы репозитория могут требовать утверждения всех запросов на вытягивание перед слиянием.

В этой статье

Сведения о проверках запроса на вытягивание

После открытия запроса на вытягивание любой пользователь с доступом на чтение может просматривать и комментировать предложенные изменения. Вы также можете предложить конкретные изменения в строках кода, которые автор может применить непосредственно из запроса на вытягивание. Дополнительные сведения см. в разделе Просмотр предлагаемых изменений в запросе на вытягивание.

По умолчанию в общедоступных репозиториях любой пользователь может отправлять отзывы, которые утверждают или запрашивают изменения запроса на вытягивание. Владельцы организации и администраторы репозитория могут ограничивать пользователей, которые могут утверждать проверки запросов на вытягивание или изменения запросов. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Управление проверками запросов на вытягивание в организации](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository)".

Владельцы репозитория и участники совместной работы могут запросить проверку запроса на вытягивание у определенного пользователя. Участники организации также могут запросить проверку запроса на вытягивание у команды с доступом на чтение к репозиторию. Дополнительные сведения см. в разделе Запрос проверки запроса на вытягивание. Вы можете указать подмножество участников команды, которые будут автоматически назначены вместо всей команды. Дополнительные сведения см. в разделе Управление параметрами проверки кода для вашей команды.

Проверки позволяют обсуждать предлагаемые изменения и помогают гарантировать, что изменения соответствуют рекомендациям по участию в разработке и другим стандартам качества репозитория. Вы можете определить, какие пользователи или команды имеют определенные типы или области кода в файле CODEOWNERS. Когда запрос на вытягивание изменяет код с определенным владельцем, этот пользователь или команда автоматически запрашивается в качестве рецензента. Дополнительные сведения см. в разделе О владельцах кода.

Общие сведения о запросах и предоставлении проверка запроса на вытягивание см. в курсе "Просмотр запросов на вытягивание GitHub Skills .

Вы можете запланировать напоминания для запросов на вытягивание, которые необходимо проверить. Дополнительные сведения см. в разделе "Управление запланированными напоминаниями для команды".

Проверка имеет три возможных состояния:

  • Комментарий. Отправляет общий отзыв, не утверждая изменения явным образом и не запрашивая дополнительные изменения.
  • Утверждение. Отправляет отзыв и утверждает слияние изменений, предложенных в запросе на вытягивание.
  • Запрос изменений. Отправляет отзыв, который необходимо обработать перед слиянием запроса на вытягивание.

Совет.

  • Параметр "Изменения запроса" является исключительно информационным и не будет препятствовать слиянию, если только набор правил или правило защиты классических ветвей настроено с параметром "требовать запрос на вытягивание". При настройке и совместном работе с admin``ownerрепозиторием или write доступе к репозиторию отправляет запрос на проверку изменений, запрос на вытягивание не может быть объединен до тех пор, пока тот же сотрудник не отправит еще одну проверку утверждения изменений в запросе на вытягивание.
  • Владельцы и администраторы репозитория могут объединить запрос на вытягивание, даже если он не получил утверждение или если рецензент, запросивший изменения, покинул организацию либо недоступен.
  • Если включены как обязательные проверки, так и отклонение устаревших проверок, то при отправке фиксации с изменением кода в ветвь утвержденного запроса на вытягивание утверждение отклоняется. Прежде чем запрос на вытягивание можно будет объединить, его необходимо будет проверить и утвердить еще раз.
  • Если несколько открытых запросов на вытягивание имеют головную ветвь, указывающую на одну и ту же фиксацию, вы не сможете объединить их, если хотя бы для одного из них имеется ожидающая выполнения или отклоненная проверка.
  • Если репозиторий требует утверждения проверок от пользователей с разрешениями на запись или администрирование, все утверждения от пользователей с этими разрешениями помечаются зеленой галочкой, а утверждения от пользователей без этих разрешений — серой галочкой. Утверждения с серой галочкой не влияют на возможность объединения запроса на вытягивание.
  • Авторы запросов на вытягивание не могут утверждать собственные запросы на вытягивание.

Вы можете просмотреть все проверки запроса на вытягивание, полученные на временной шкале беседы, и можете просмотреть отзывы владельцев репозитория и участников совместной работы в поле слияния запроса на вытягивание.

Снимок экрана: поле слияния для запроса на вытягивание. Отображается проверка октоката с запрошенными изменениями.

Совет. С помощью квалификатора поиска review-requested:[USERNAME] или team-review-requested:[TEAMNAME] вы можете найти запрос на вытягивание с запросом на проверку, адресованным вам или команде, участником которой вы являетесь. Дополнительные сведения см. в разделе Поиск проблем и запросов на вытягивание.

Разрешение бесед

Вы можете разрешить беседу в запросе на вытягивание, если вы открыли запрос на вытягивание или у вас есть доступ на запись в репозиторий, где был открыт запрос на вытягивание.

Чтобы указать, что беседа на вкладке Измененные файлы завершена, нажмите кнопку Разрешить беседу.

Вся беседа будет свернута и помечена как разрешенная, что упрощает поиск бесед, которые все еще требуют разрешения.

Если предложение в комментарии выходит за пределы области вашего запроса на вытягивание, можно открыть новую проблему, которая отслеживает обратную связь и связывает ее с исходным комментарием. Дополнительные сведения см. в разделе Создание проблемы.

Обнаружение и навигация по беседам

Вы можете обнаружить все беседы и перейти к ним в запросе на вытягивание с помощью меню Беседы, которое отображается в верхней части вкладки Измененные файлы.

В этом представлении можно увидеть, какие беседы являются неразрешенными, разрешенными и устаревшими. Это упрощает обнаружение и разрешение бесед.

Снимок экрана: меню "Беседы" на вкладке "Измененные файлы" запроса на вытягивание.

Повторный запрос проверки

Например, после внесения существенных изменений в запрос на вытягивание можно повторно запросить проверку. Чтобы запросить выполнение новой проверки проверяющим, на боковой панели вкладки Беседа щелкните значок .

Обязательные проверки

Администраторы репозитория или пользовательские роли с разрешением "Изменить правила репозитория" могут требовать, чтобы все запросы на вытягивание получали определенное количество утверждений, прежде чем кто-то объединяет запрос на вытягивание в защищенная ветвь. Вы можете требовать утверждения проверок от пользователей с разрешениями на запись в репозиторий или от назначенного владельца кода. Дополнительные сведения см. в разделе "Сведения о защищенных ветвях".

Совет. При необходимости пользователи с доступом администратора или доступом на запись в репозитории могут закрыть проверку запроса на вытягивание. Дополнительные сведения см. в разделе Отклонение проверки запроса на вытягивание.

Дополнительные материалы