Салют! Этот гайд посвящается основной вещи, которая позволяет вести работу в команде — пулл-реквестам. Пулл-реквесты (pull-requests) позволяют вести командную работу при помощи Git’a и сайта GitHub, а именно позволяют объединять наработки всех людей в один репозиторий.
В этой статье мы научимся делать пулл-реквесты на примере нашего репозитория, с которым мы будем работать весь семестр.
Для начала переходим в репозиторий проекта по этой ссылке и нажимаем на кнопку “Fork”.
У вас откроется небольшое меню. Все что надо сделать тут — это нажать на кнопку “Create fork”.
Отлично! Мы форкнули репозиторий (т.е. буквально — создали “вилку” или ответвление). Теперь этот репозиторий числится в списке репозиториев на вашем аккаунте и мы можем с ним работать.
Далее нам необходимо сгенерировать SSH-ключ, который даст понять GitHub’у, что именно ваш компьютер может работать с вашим аккаунтом.
Открываем консоль Git Bash (через пуск, чтобы консоль открылась в корне) и пишем следующую команду:
ssh-keygen
После ввода этой команды вы должны несколько раз нажать Enter до тех пор, пока ввод не кончится и на экране не появится красивая картинка (как на примере выше).
SSH-ключ сгенерирован. Теперь переходим по директории, где был помещен этот ключ и выводим его содержимое на экран:
cd .ssh/ # переходим по пути ключа
cat id_rsa.pub # выводим содержимое файла id_rsa.pub на экран
Мы должны скопировать все, что выдала команда cat (т.е. от ssh-rsa и до последнего символа включительно) и перейти по этой ссылке.
В поле “Title” вводим любое название на латинице, а в поле “Key” вставляем скопированный ssh-ключ. Нажимаем “Add SSH key”.
Переходим на сайт своего форкнутого репозитория (нажимаем на иконку вашего пользователя на гитхабе → кнопка “Your repositories” и жмем на airborne-crew). Нажимаем на зеленую кнопку “Code”, затем на надпись “SSH”, затем на иконку файлика и копируем SSH-ссылку на репозиторий.
Теперь создаем в любом удобном месте папку, где будет наш репозиторий и открываем ее через Git Bash (надеюсь, вы уже знаете как это делать). После того, как открыли, пишем следующую команду:
git clone SSH-ссылка
Теперь убедимся, что весь репозиторий сохранился на наш компьютер:
cd airborne-crew/ # переходим в подкаталог airborne-crew/
ls # выводим список файлов в этом подкаталоге - должно вывестись LICENSE и README.md
Далее пишем следующую команду:
code README.md # открываем в VS Code файлик README.mdВ VS Code у вас должен открыться этот файл. В нем по пунктам вы пишите свою фамилию и имя. Обязательно сохраняем, нажав Ctrl + S.
После этого мы можем убедиться в том, что вы изменили файл:
git status # выведет в консоль состояние текущих файлов
# modified - значит изменен
Перед пулл-реквестом нам необходимо задать гиту вашу почту. Пишем следующую команду:
git config --global user.email "ваша-почта@почта.сру"
Теперь приступаем к коммиту (т.е. к тому, чтобы изменения на вашем компьютере перенеслись в репозиторий). Пишем следующий список команд:
git add README.md # добавляем файл README.md в список коммита
git commit -m "TEXT" # делаем коммит с комментарием "TEXT"
git push -u origin main # загружаем все в репозиторий
# прим.: команду git push -u origin main надо написать только первый раз
# в следующий раз можно просто написать git push
Теперь заходим по ссылке форкнутого репозитория (ВАЖНО! не мой репозиторий, а именно ваше ответвление, которое вы сохранили себе на гитхаб во вкладку “Your repositories”). Нажимаем на кнопку “Contribute” (1), затем на кнопку “Open pull request” (2).
После этого у вас откроется меню, в котором вы сможете оставить более подробный комментарий. Наконец, жмем на кнопку “Create pull request”.
Готово! Не забудьте добавить репозиторий в избранное, чтобы вы отображались во вкладке “контрибьютеры”.
