Упражнение: Создать, проверить и слить pull request

5 мин

Вы завершили работу по добавлению очереди на ваш веб-сайт. Теперь команда разработки веб-сайтов готова, чтобы вы слили изменения в основную ветку. В этом упражнении вы создадите и объедините pull request для ваших изменений.

Во время процесса вы выполните следующие действия.

Создайте pull request.
Просмотрите пулл-реквест.
Завершите пулл-реквест.
Убедитесь, что изменения были объединены.

Создание запроса на слияние для объединения фича-ветки

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

В вашем браузере перейдите в раздел код.
Выберите 2 ветки для отображения списка веток в вашем репозитории GitHub.
Рядом с очередью добавления заказоввыберите значок "Дополнительно" (...), а затем выберите Новый pull request.
Когда вы создали pull request, обратите внимание, что GitHub автоматически использовал сообщение commit Git в качестве заголовка pull request.

Обновите описание до следующего текста:

Этот PR добавляет новую очередь Azure Storage для обработки заказов и обновляет конфигурацию веб-сайта, чтобы включить учетную запись для хранения и информацию о очереди.
Выберите Создать запрос на изменение.

В браузере перейдите в Репозиторий>Файлы.

Обратите внимание, что Azure DevOps отображает баннер, указывающий на наличие изменений в ветви add-orders-queue. Баннер предлагает создать пулл-реквест для изменений.
Выберите Создать pull-запрос.
На странице создания запроса на слияние обратите внимание, что Azure DevOps автоматически использовал сообщение фиксации Git в качестве заголовка запроса на слияние.

Обновите описание до следующего текста:

Этот PR добавляет новую очередь Azure Storage для обработки заказов и обновляет конфигурацию веб-сайта, чтобы включить учетную запись хранения и информацию о очереди.
Выберите Создать.

Просмотр пулл-реквеста

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

На странице запроса на слияние выберите вкладку Измененные файлы.

GitHub показывает файлы, которые были изменены в этом pull request. Обратите внимание, что он выделяет все измененные строки, поэтому вы можете легко увидеть, что следует просмотреть.

Кончик

Представьте, что вы просматриваете это для своей команды. Вы бы сделали какие-либо предложения?
В изменённом файле main.bicep наведите курсор на строку 18 и выберите кнопку с знаком плюс (+).
В поле комментариев введите следующий текст: следует ли это заглавить?
Выберите Запустить проверку.

Совет

GitHub не позволяет одобрять собственные pull запросы. Здесь вы оставите комментарий к pull-запросу, но не одобрите его. Когда вы работаете с pull-запросами вашей команды, это момент, когда вы одобряете его, чтобы сообщить, что вы согласны на объединение.
Выберите Завершить проверку.
На появившейся панели обзора выберите Отправить проверку.

GitHub возвращает вас на вкладку беседы запроса на вытягивание.

На странице запроса на вытягивание выберите вкладку Файлы.

В этом пулреквесте показываются файлы, которые были изменены в Azure DevOps. Обратите внимание, что он выделяет все измененные строки, поэтому вы можете легко увидеть, что следует просмотреть.

Совет

Представьте, что вы просматриваете это для своей команды. Вы бы сделали какие-либо предложения?
В файле main.bicep, который был изменен, наведите указатель мыши на строку 18 и нажмите кнопку комментария.
В поле комментариев введите следующий текст: следует ли это заглавить?
Выберите примечание.

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

После того как вы выберете Утверждение, Установить автозавершение меняется на Завершено. Эта функция будет использоваться позже в этом уроке.

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

При создании или просмотре pull-запроса вы можете участвовать в обсуждении его содержимого. Представьте, что вы автор этого файла, и вы хотите ответить на комментарий от рецензента.

Ответьте на ревью pull request со следующим комментарием: Нет, очереди хранилища должны иметь строчные имена.
Выберите Комментарий, а затем выберите Закрыть обсуждение, чтобы указать, что обсуждение на этой строке завершено.

На странице pull request выберите вкладка Обзор.
Теперь представьте, что вы автор этого файла. Ответьте на обзор pull request со следующим комментарием: Нет, очереди хранилища должны иметь строчные имена.
Выберите ответ & решить, чтобы указать, что обсуждение вопроса закончено.

Завершите pull-запрос

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

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

Выберите выполнить слияние запроса на вытягивание.
GitHub просит подтвердить слияние. Когда GitHub сливает pull request, он создает коммит и автоматически генерирует сообщение коммита. Выберите , подтвердите слияние.

Ваш pull request объединён, и ваша новая функция теперь находится в основной ветке репозитория.
Рекомендуется удалить ветви функций, когда вы закончите работу с ними. Удаление ветвей помогает избежать путаницы у членов команды в будущем относительно того, какая работа все еще продолжается. Выберите Удалить ветвь.

Выберите Завершить.
С полностью выполните запрос на вытягивание, используя параметры по умолчанию. Выберите Завершить слияние.

Ваш пулл-реквест объединен, и ваша новая функция теперь находится в основной ветке репозитория.

Azure DevOps автоматически удалил фича-ветку при объединении pull request. Рекомендуется удалить ветви функций, когда вы закончите работу с ними. Удаление ветвей помогает избежать путаницы в команде в будущем относительно того, какая работа по-прежнему выполняется.

Проверка изменений

После объединения pull request рекомендуется проверить, что выполнено объединение изменений.

Перейдите к коду.
Перейдите в файл deploy/main.bicep, а затем в файл deploy/modules/appService.bicep.

Обратите внимание, что очередь и другие изменения теперь находятся в файлах.