Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

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

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

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

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

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

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

Заголовок проверки запрашивающего изменения с комментариями к строкам

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

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

Изображение состояний проверки

Совет.

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

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

Изображение проверок в поле слияния

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

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

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

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

Беседа по запросу на вытягивание с кнопкой "Разрешить беседу"

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

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

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

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

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

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

Отображение меню бесед

Повторная отправка запроса на проверку

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

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

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

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

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