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

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

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

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

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

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

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

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

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

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

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. Список измененных файлов и изменения по отдельному файлу.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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