Обработка запроса на вытягивание

  • Статья

После открытия запроса на вытягивание (PR), pr проходит набор проверка и проверок, чтобы убедиться, что предложенные изменения можно объединить. Дополнительные сведения о PR см . в основах Git и GitHub.

Проверка

Перед объединением PR в целевую ветвь может потребоваться пройти один или несколько процессов проверки PR. После нажатия кнопки "Создать запрос на вытягивание" GitHub запускает проверки, настроенные для репозитория. После завершения процесса проверки результаты отображаются в PR.

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

  • Возможность слияния: сначала происходит базовый тест слияния GitHub, чтобы убедиться, что предложенные изменения в ветви конфликтуют с целевой ветвью. Если pr указывает, что этот тест завершился ошибкой, необходимо примирить содержимое, вызывающее конфликт слияния, прежде чем продолжить обработку.
  • Лицензионное соглашение о вкладе (CLA) — как не microsoft участник, если вы вносите свой вклад в общедоступный репозиторий, вам может потребоваться выполнить короткое соглашение об уровне обслуживания при первом отправке pr в этот репозиторий. После очистки шага CLA ваш PR обрабатывается.
  • Маркировка. Метки автоматически применяются к вашему PR, чтобы указать состояние pr, как оно проходит через рабочий процесс проверки. Например, новые PR могут автоматически получать метку "не слияние", указывая, что pr еще не завершил проверку, проверку, проверку и выход из нее.
  • Проверка и сборка. С помощью автоматических проверок определяется, прошли ли изменения проверочные тесты. Тесты проверки могут выдавать предупреждения или ошибки, требуя отредактировать один или несколько файлов в pr, прежде чем его можно объединить. Результаты проверки добавляются в качестве комментария в вашем pr для проверки, и они могут быть отправлены вам по электронной почте.
  • Промежуточное выполнение. После успешной проверки и сборки измененные статьи автоматически развертываются в промежуточной среде для проверки. URL-адреса для проверки добавляются в комментарии запроса на вытягивание.
  • Автоматическое слияние: pr может быть автоматически объединен, если он проходит проверку и определенные критерии. В этом случае вам не нужно делать ничего другого.

Рецензирование и отзыв по адресу

После завершения обработки pr следует просмотреть результаты (например, комментарии pr, результаты сборки). Определите, нужно ли вносить дополнительные изменения, прежде чем вы входите в систему для объединения. Возможно, вам потребуется изменить содержимое по следующим причинам:

  • Комментарии pr от рецензентов. Если рецензент pr рассмотрел ваш pr, он может предоставить отзыв через комментарии, если есть невыполненные проблемы или вопросы, которые необходимо устранить перед слиянием.
  • Отзывы от одноранговых рецензентов.
  • Исправление форматирования из-за проблем с отрисовкой.
  • Ошибки проверки или предупреждения.
  • Конфликты слияния.

Если вам нужно внести изменения, вы можете изменить содержимое непосредственно в PR или вернуться в VS Code, чтобы внести изменения. По завершении зафиксируйте изменения в рабочей ветви. Pr-запрос автоматически обновляется с изменениями.

При каждом добавлении фиксации в ту же рабочую ветвь фиксация автоматически добавляется в PR. При каждой фиксации система публикации повторно запускает процессы проверки и проверки автоматически.

Автоматизация входа и комментариев

Когда вы обратились ко всем ошибкам обратной связи и проверки, и вы готовы к объединению изменений, пришло время выйти на ваш PR, создав новый комментарий, который читает #sign-off. Чтобы объединить изменения, необходимо ввести #sign-off комментарий. Даже если все проверки и проверки проверка передаются, вы несете ответственность за использование этого комментария, чтобы сообщить рецензентам PR и администраторам репозитория, что ваши изменения готовы к слиянию.

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

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

Комментарий хэштега Что он делает
#sign-off Автоматически назначает метку готовности к слиянию , чтобы рецензенты в репозитории знали, что pr готов к проверке и слиянию.

Если вы не являетесь автором списка и пытаетесь выйти из общедоступного репозитория с помощью #sign-off комментария, он обновляется, чтобы указать, что только автор может назначить метку.
#hold-off Удаляет метку готовности к слиянию в случае изменения вашего ума или ошибки. В частном репозитории при этом назначается метка запрета слияния.
#please-close Закрывает pr, если вы решили не объединить изменения.
#please-open Повторно открывает закрытый pr-запрос или проблему.

Публикуется

Перед включением изменений в следующий запланированный запуск публикации необходимо объединить рецензент pr. Как правило, PR проверяются и объединяются в порядке отправки.

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

После публикации изменений они живут в Microsoft Learn для других пользователей, чтобы начать обучение с!

Следующие шаги

Вот и все! Вы внесли свой вклад в содержимое Microsoft Learn!