Создание запроса

Запрос на слияние (pull request) — основная функция системы контроля версий. Через запрос вы предлагаете свои изменения и запрашиваете проверку (ревью) у соавторов репозитория.

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

Новый запрос отобразится:

• среди запросов репозитория;
• на дашборде запросов.

Подробный пример создания и выполнения запроса на слияние при совместном ревью для защищенной ветки описан в разделе Слияние запроса.

Warning

1. Создатель запроса для защищенной ветки с заданным минимальным числом ревьюеров не сможет самостоятельно выполнить слияние, т.к. создатель не может быть ревьюером.
2. Если в защищенной ветке выставлено ограничение на расширения файлов и такие файлы меняются в коммитах, то слияние будет заблокировано.
3. Для ранее созданных запросов обновление правил защиты происходит спустя некоторое время.
4. Соавтор-владелец запроса может отменить ревью для другого соавтора.

Варианты создания запроса

Форма создания запроса предзаполнена в зависимости от репозитория-источника запроса, для форка репозитория дополнительно доступны для слияния ветки оригинала.

Баннер в профиле репозитория

Если вы недавно обновляли ветку, GitVerse автоматически отображает баннер с предложением создать запрос на слияние в master-ветку на странице Репозиторий → Код.

Чтобы создать запрос через баннер:

1. Перейдите на вкладку Репозиторий → Код в профиле репозитория.
2. Найдите баннер с именем нужной ветки в верхней части страницы. Баннер содержит время последнего изменения, например: testing-branch изменена ветка 5 минут назад.
3. Нажмите Создать запрос на слияние в строке нужной ветки.
4. Откроется форма создания запроса с предзаполненными полями:
   • из ветки, в которой произошли изменения;
   • в ветку — целевая ветка репозитория, куда вносятся изменения;
   • название и описание — предзаполняется автоматически.
5. Проверьте данные, при необходимости отредактируйте и нажмите Создать запрос.

Простой запрос

Если репозиторий не является форком, то для слияния доступны только его собственные ветки.

1. Для перехода на форму создания нового запроса в профиле репозитория выберите Запросы, нажмите Создать новый запрос.

2. Укажите:

   1. Ветку-источник.
   2. Целевую ветку.
   3. (Необязательно) назначьте ревьюеров, их можно переназначить позже на странице запроса.
   4. (Необязательно) отредактируйте название запроса.
   5. (Необязательно) отредактируйте описание запроса.
   6. Нажмите Создать запрос.

Запрос из форка репозитория

При создании запроса из форка репозитория дополнительно доступны для слияния ветки оригинального репозитория.

1. В форке репозитория перейдите на вкладку Запросы и нажмите Создать новый запрос.

2. Укажите:

   1. Исходный репозиторий — форк или оригинал.
   2. Ветку исходного репозитория.
   3. Целевой репозиторий — форк или оригинал.
   4. Ветку целевого репозитория.
   5. (Необязательно) ревьюеров, их можно переназначить позже на странице запроса.
   6. (Необязательно) отредактируйте название запроса.
   7. (Необязательно) отредактируйте описание запроса.
   8. Нажмите Создать запрос.

Запрос при коммите с созданием новой ветки

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

1. При создании коммита выберите Создать новую ветку.

2. Появится новое поле и чекбокс. Далее:

   1. (Необязательно) в новом поле отредактируйте название новой ветки для коммита.
   2. Отметьте чекбокс, нажмите Сохранить.

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

Запрос на странице задачи

Создание запроса на странице задачи см. на странице Ветки и запросы в задачах.

Описание изменений в запросе

После того как вы выбрали ветки для запроса, отобразится краткая информация по изменениям запроса:

1. Коммиты.

2. Измененные файлы.

3. Список измененных файлов и изменения по отдельному файлу.

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

5. Сводная информация по измененным файлам включает в себя:

   1. Файлы — общее число добавленных и измененных файлов.
   2. Добавлено — число добавленных файлов.
   3. Изменено — число измененных файлов.
   4. Изменение строк в файле:
      • добавлено — совокупное число добавленных строк по всем файлам;
      • удалено — совокупное число удаленных строк по всем файлам.

6. В измененных файлах можно получить подробную информацию об изменениях.

Изменение названия запроса

1. Выберите нужный запрос, например, на дашборде запросов.

2. Нажмите на название запроса.

3. Отобразится модальное окно.

4. Введите новое название запроса и нажмите кнопку Переименовать.

5. Отобразится страница запроса с новым названием.

Дальнейшие шаги

Что можно сделать далее:

• добавьте соавторов и ревьюеров;
• проверьте правила защиты ветки;
• добавьте вебхуки, чтобы получать уведомления на сторонних сервисах о событиях в вашем репозитории на GitVerse.

Связанные разделы

1. Вкладка «Измененные файлы» запроса.