Робочий процес розгалуження функції в Git
Функціональний робочий процес відділення¶
Цей популярний робочий процес git передбачає створення нових гілок для кожної нової функції або виправлень безпосередньо в основному сховищі. Зазвичай він використовується в проектах, де учасники мають прямий push-доступ до сховища.
Цей документ описує процес налаштування локального сховища для роботи та внеску в проект rocky-linux/documentation
за допомогою робочого процесу Git Feature Branch.
Користувач «rockstar» розгалужив це сховище, і ми будемо використовувати https://github.com/rockstar/documentation
як джерело.
Передумови¶
- Обліковий запис GitHub і гілка проекту (наприклад,
https://github.com/rockstar/documentation
). - встановлені
git
таGitHub CLI (gh)
.
Процедура¶
- Якщо це ще не зроблено, клонуйте вашу гілку:
git clone https://github.com/rockstar/documentation.git
cd documentation
- Додайте дистанційне керування:
git remote add upstream https://github.com/rocky-linux/documentation.git
- Отримайте зміни:
git fetch upstream
- Створіть нову гілку функції:
git checkout -b feature-branch-name
- Внесіть зміни, додайте нові файли та зафіксуйте їх:
git add .
git commit -m "Implementing feature X"
- Тримайте свою гілку оновленою. Регулярно об’єднуйте зміни з висхідного потоку, щоб уникнути конфліктів:
git pull upstream main --rebase
- Запушіть вилку, введіть:
git push origin feature-branch-name
- Створіть запит:
gh pr create --base main --head rockstar:feature-branch-name --title "New Feature X" --body "Long Description of the feature"
Висновок¶
Робочий процес Feature Branch — це поширена техніка співпраці, яка дозволяє командам одночасно працювати над різними аспектами проекту, зберігаючи при цьому стабільну основну кодову базу.
Задіяні кроки високого рівня:
- Клонуйте основне сховище: безпосередньо клонуйте основне сховище проекту на вашій локальній машині.
- Створіть гілку функцій: для кожного нового завдання створіть нову гілку головної гілки з описовою назвою.
- Зафіксуйте зміни: попрацюйте над функцією або виправте у своїй гілці та зафіксуйте зміни.
- Підтримуйте оновлення гілки: регулярно об’єднуйте або перебазуйте з основною гілкою, щоб бути в курсі змін.
- Відкрийте запит на отримання: перемістіть гілку в головне сховище та відкрийте PR для перегляду, коли ваша функція буде готова.
- Перегляд коду та злиття: гілка об’єднується в основну гілку після перегляду та затвердження.
Переваги:
- Спрощує внески для постійних учасників із прямим доступом до сховища.
- Забезпечує перевірку кожної функції перед інтеграцією в основну кодову базу.
- Допомагає підтримувати чисту та лінійну історію проекту.
Author: Wale Soyinka
Contributors: Ganna Zhyrnova