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

Запрос на слияние (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. Введите новое название запроса и нажмите кнопку Переименовать:

   

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

   

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

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

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

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

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