[HOWTO] Как делать merge request (запрос на внесение готовых изменений) в XVM

[night_dragon_on 5,601]

 

 

«Merge Request'ы» позволяют вам рассказать разработчикам о тех изменениях, которые вы разместили в своей копии репозитория (в форке). Как только merge request отправлен, заинтересованные стороны рассматривают ваши изменения, обсуждают возможные правки или даже добавляют дополняющие коммиты, если нужно. Другими словами: посылая merge request, вы говорите автору изначального репозитория: «Смотрите, что я сделал, не хотите ли принять мои изменения и влить их в проект?»

Cоздание Merge Request'а:

     1. Регистрация на GitLab.com
     2. Создание форков
     3. Первоначальная настройка клиента Git (на примере SmartGit)
     4. Заливка изменений (на примере SmartGit)
     5. Отправка Merge Request'а

Дополнение:

     •  Отмена и/или изменение коммита (на примере SmartGit)

[night_dragon_on 5,601]

 Регистрация на GitLab.com

1.1. Переходим на страницу на GitLab.com
1.2. Заполняем форму:

     

1.3. Завершаем регистрацию, входим на сайт под своим аккаунтом.
1.4. Для удобства настроим локализацию сайта, переходим на страницу настроек.
       Выбираем в поле "Localization" > "Language" пункт "Русский"

     

Edited November 3, 2019 by night_dragon_on
Обновление ...

[night_dragon_on 5,601]

 Создание форков

Нам необходимо создать форк репозитория XVM.

Форк - это ответвление от основного репозитория с исходным кодом XVM. В этом ответвлении вы можете вносить любые изменения
для того, чтобы затем подать запрос на их включение в основной репозиторий (такой запрос называется merge request).

2.1. Переходим на страницу главного репозитория XVM.
2.2. Жмем кнопку "Fork":

     

2.3. Выбираем свой аккаунт:

     

2.4. Ждем завершения процесса ответвления.
2.5. Для поддержания репозитория (форка) в актуальном состоянии вам необходимо настроить автоматическое его обновление в соответствие с изменениями вносимыми в оригинальный репозитории XVM. Для этого выполняем следующие операции.
2.6. Открываем вкладку "Проекты" > "Ваши проекты" на сайте, перейдя по ссылке.
       Выбираем форк репозитория XVM.

     

2.7. На странице форка в меню выбираем "Настройки" > "Репозиторий":

     

2.8. В открывшемся окне в разделе "Mirroring repositories" вам необходимо ввести адрес репозитория XVM в указанном поле:
       https://gitlab.com/xvm/xvm.git

     

2.9. После нажатия на клавишу "Mirror repository" ниже в списке вы увидите новый пункт:

     

2.10. Ваш форк успешно синхронизирован с основным репозиторием.

Edited November 3, 2019 by night_dragon_on
Обновление ...

[night_dragon_on 5,601]

 Первоначальная настройка клиента Git (на примере SmartGit)

3.1. Переходим на страницу загрузки дистрибутива.
3.2. Устанавливаем SmartGit.
3.3. Запускаем SmartGit.
3.4. Принимаем лицензионное соглашение, выбираем в списке некоммерческое использование.

     

3.5. Ждем окончания работы таймера, принимаем условия:

     

3.6. На следующем этапе заполняем форму:

     

3.7. Далее в открывшемся главном окне выбираем пункт для клонирования вашего репозитория (форка):

     

3.8. Открываем вкладку "Проекты" > "Ваши проекты" на сайте, перейдя по ссылке.
       Выбираем форк репозитория XVM.

     

3.9. На странице форка нажимаем на клавишу "Клонировать", копируем ссылку в буфер обмена:

     

3.10. Данную ссылку вставляем в указанное поле в окне SmartGit, нажимаем "Next":

     

3.11. При необходимости вводим мастер-пароль (необязательно):

     

3.12. На следующей странице вводим логин и пароль аккаунта GitLub, нажимаем "Login":

     

3.13. Выбираем ветку для клонирования, нажимаем "Next":

     

3.14. Указываем расположение локального репозитория на вашем ПК:

     


P.S.: В случае если вы в пункте 3.9 вы скопировали не HTTPS ссылку, а SSH то вместо логина и пароля (см. пункт 3.12) вам необходимо для продолжения клонирования репозитория (форка) указать SSH-ключ в данном всплывающем окне:

     

Так как данного ключа у вас нет, то вам его необходимо сгенерировать.

         Переходим в директорию программы SmartGit, по умолчанию путь до нее: C:\Program Files\SmartGit
         Открываем папку git , запускаем исполняемый файл git-bash.exe 
         Вводим команду в терминал: ssh-keygen -t ed25519 -C "[email protected]"
         Где взамен [email protected] вводим адрес вашей почты, нажимаем Enter.
         Вводим, при необходимости (иначе будет присвоено автоматически), наименование для вашего ключа, нажимаем Enter.
         Вводим пароль, нажимаем Enter. Повторно подтверждаем свой пароль, нажимаем Enter.
         Ключ сгенерирован, он сохранился по пути C:\Users\Admin\.ssh , где "Admin" наименование вашей учетной записи.

Привязываем ключ к своему аккаунту GitLub на данной странице.
Открываем ключ с расширением *.pub любым текстовым редактором, копируем его содержимое в поле "Ключ".
Подтверждаем нажатием на клавишу "Добавить ключ":

     

В окне выбираем файл ключа, без расширения *.pub , вводим пароль, нажимаем "Login":

     

Подтверждаем:

     

Далее выполняем действия в соответствие с пунктами 3.13-3.14.

Edited November 3, 2019 by night_dragon_on
Обновление ...

[night_dragon_on 5,601]

 Заливка изменений (на примере SmartGit)

4.1. Открываем SmartGit, выбираем репозиторий в поле "Repositories":

     

4.2. Вносим изменения в файлы XVM.
4.3. Вводим сообщение для коммита в поле "Commit", в поле "Files" будут отображены файлы с внесенными изменениями:

     

4.4. Нажимаем кнопку "Commit", об успешной фиксации изменений свидетельствует следующее сообщение:

     

4.5. Заливаем изменения в удаленный репозиторий, нажимаем кнопку "Push":

     

4.6. Подтверждаем отправку изменений:

     

4.7. Вводим логин и пароль от вашего аккаунта на GitLub, нажимаем "Login":

     

4.8. Ждем завершения процесса:

     

4.9. Изменения успешно слиты.

Edited November 3, 2019 by night_dragon_on
Обновление ...

[night_dragon_on 5,601]

 Отправка Merge Request'а

5.1. Открываем вкладку "Проекты" > "Ваши проекты" на сайте, перейдя по ссылке.
       Выбираем форк репозитория XVM.

     

5.2. На странице форка открываем пункт меню "Запросы на слияние":

     

5.3. Создаем новый запрос:

     

5.4. В окне создания запроса выбираем начальный репозиторий (форк) его ветку и конечный репозиторий проекта:

     

5.5. Вводим наименование вашего запроса:

     

5.6. Подтверждаем создание запроса:

     

5.7. Запрос успешно создан:

     

5.8. Ожидаем решения со стороны разработчиков мода о внесении изменений или отклонении запроса.

Edited November 3, 2019 by night_dragon_on
Обновление ...

[night_dragon_on 5,601]

 Отмена и/или изменение коммита (на примере SmartGit)

В данном примере разберем процесс работы с командой "Force Push".
Данная команда поможет вам:

     •  отменить коммит;
     •  изменить коммит (наименование, содержимое и т.п.);
     •  обновить Merge Request.

Отправленный в удаленный репозиторий без необходимости создания дополнительных коммитов.
В видеофайле продемонстрирован пример отмены коммита old commit и заливка нового с наименованием new commit на примере клиента SmartGit.

     •  https://youtu.be/8SoMlMAhq98

Аналогично можно обновить ваш коммит который вы отправили Merge Request-ом.
Последний будет обновлен после того как вы зальете обновленный коммит в ваш форк.