3.3 Розгалуження в Git - Управління гілками
Тепер, коли ви вже спробували створювати, об'єднувати та видаляти гілки, настав час познайомитися з деякими інструментами для управління гілками, які вам знадобляться, коли ви почнете використовувати гілки постійно.
Команда git branch робить трохи більше, ніж просто створює та видаляє гілки. При запуску без параметрів ви отримаєте простий список наявних у вас гілок:
$ git branch iss53 * master testing
Зверніть увагу на символ * , що стоїть перед гілкою master : він вказує на гілку, на якій ви зараз перебуваєте (тобто гілку, на яку вказує HEAD ). Це означає, що якщо ви зараз зробите коміт, гілка master переміститься вперед відповідно до останніх змін. Щоб переглянути останній коміт на кожній із гілок, виконайте команду git branch -v :
$ git branch -v iss53 93b412c Fix javascript issue * master 7a98805 Merge branch 'iss53' тестування 782fd34
Опції --merged та --no-merged можуть відфільтрувати цей список для виведення лише тих гілок, які злиті або ще не злиті в поточну гілку. Щоб подивитися ті гілки, які ви злили з поточної, можете виконати команду git branch --merged :
$ git branch --merged iss53 * master
Гілка iss53 присутня в цьому списку, тому що ви раніше злили її в master. Ті гілки цього списку, перед якими немає символу * , можна сміливо видаляти командою git branch -d ; напрацювання з цих гілок вже включені в іншу гілку, тому нічого не загубиться.
Щоб побачити всі галузі, що містять напрацювання, які ви ще не злили в поточну гілку, виконайте команду git branch --no-merged :
$ git branch --no-merged testing
Ви побачите гілку, що залишилася. Оскільки вона містить ще не злиті напрацювання, спроба видалити її командою git branch -d призведе до помилки:
$ git branch -d testing error: The branch 'testing' is not fully merged. Якщо ви вважаєте, що ви хочете, це 'git branch -D testing'.
Якщо ви дійсно хочете видалити гілку разом з усіма напрацюваннями, використовуйте опцію -D, як зазначено у підказці.
Якщо як аргумент не вказано комміт або гілка, то опції --merged і --no-merged покажуть що вже злито або не злито з вашої поточною гілкою відповідно.
Ви завжди можете вказати додатковий аргумент для виведення тієї ж інформації, але щодо зазначеної гілки попередньо не виймаючи і не переходячи на неї.
$ git checkout testing $ git branch --no-merged master topicA featureB
Перейменування гілки
Не перейменовуйте гілки, які ще використовуються іншими учасниками. Не перейменовуйте гілку на master/main/mainline, не прочитавши розділ «Зміна імені головної гілки».
Припустимо, у вас є гілка з ім'ям bad-branch-name, і ви хочете змінити її на correctod-branch-name, зберігши при цьому всю історію. Разом з цим ви також хочете змінити ім'я гілки на віддаленому сервері (GitHub, GitLab або інший сервер). Як це зробити?
Перейменуйте гілку локально за допомогою команди git branch --move :
$ git branch --move bad-branch-name correctod-branch-name
Гілка bad-branch-name буде перейменована в correctod-branch-name , але ця зміна поки що локальна. Щоб інші побачили виправлену гілку у віддаленому репозиторії, відправте її туди:
$ git push --set-upstream origin correctod-branch-name
Тепер перевіримо, де ми зараз знаходимося:
$ git branch --all * correct-branch-name main remotes/origin/bad-branch-name remotes/origin/corrected-branch-name remotes/origin/main
Зверніть увагу, що поточна гілка correctod-branch-name , яка також є і на віддаленому сервері. Однак, стара гілка все ще там, але її можна видалити за допомогою команди:
$ git push origin --delete bad-branch-name
Тепер старе ім'я гілки повністю замінено на виправлене.
Зміна імені головної гілки
Зміна імені гілки, наприклад master/main/mainline/default, зламає інтеграції, служби, допоміжні утиліти та скрипти збирання, які використовує ваш репозиторій. Перш ніж це зробити, обов'язково проконсультуйтеся з колегами. Також переконайтеся, що ви здійснили ретельний пошук у своєму репозиторії та оновили всі посилання на старе ім'я гілки у вашому коді чи скриптах.
Перейменуйте локальну гілку master на main за допомогою наступної команди:
$ git branch --move master main
Після цього локальної гілки master більше не існує, тому що вона була перейменована на гілку main .
Щоб решта могли бачити нову гілку main , вам потрібно відправити їх у загальний репозиторій. Це робить перейменовану гілку доступною у віддаленому репозиторії.
$ git push --set-upstream origin main
У результаті стан репозиторію стає таким:
$ git branch --all * main remotes/origin/HEAD -> origin/master remotes/origin/main remotes/origin/master
Ваша локальна гілка master зникла, оскільки вона замінена гілкою main . Гілка main доступна у віддаленому репозиторії. Стара гілка master все ще присутня у віддаленому репозиторії. Інші учасники будуть продовжувати використовувати гілку master як основу для своєї роботи, поки ви не здійсните низку додаткових дій.
Тепер для завершення переходу на нову гілку перед вами стоять такі завдання:
- Усі проекти, які залежать від поточного, повинні будуть оновити свій код та/або конфігурацію.
- Обновіть конфігурацію всіх тестів, що запускаються.
- Виправте скрипти складання та публікації артефактів.
- Поправте налаштування репозиторію на сервері: встановіть нову гілку за промовчанням, оновіть правила злиття, а також інші налаштування, які залежать від імені гілок.
- Оновіть документацію, виправивши посилання, які вказують на стару гілку.
- Злийте або скасуйте запити на злиття змін, націлені на стару гілку.
Після того, як ви виконали всі ці завдання і впевнені, що гілка main працює так само, як гілка master, ви можете видалити гілка master:
$ git push origin --delete master
3.4 Розгалуження в Git - Робота з гілками
Тепер, коли ви познайомилися з основами розгалуження і злиття, виникає питання: що можна чи потрібно робити з цим?
Довгоживучі гілки
Так як у Git застосовується просте тристороннє злиття, ніщо не заважає багаторазово об'єднувати гілки протягом тривалого часу. Це означає, що у вас може бути кілька відкритих гілок, які ви використовуєте для різних етапів вашого циклу розробки; гілки в іншу.
Багато розробників, які використовують Git, дотримуються саме такого підходу, залишаючи повністю стабільний код лише у гілці master — можливо, тільки той код, який був або випущений.При цьому існує і паралельна гілка з ім'ям develop або next, призначена для роботи та тестування стабільності; вона не обов'язково повинна бути завжди стабільною, але при досягненні стабільного стану її вміст можна злити у гілку master. Вона використовується для злиття завершених завдань із тематичних гілок (тимчасових гілок на кшталт iss53 ), щоб гарантувати, що ці завдання проходять тестування і не роблять помилок.
По суті, ми говоримо про покажчики, що переміщаються по лінії коммітів, які ви створюєте. Стабільні гілки знаходяться в нижньому кінці історії коммітів, а найсвіжіші напрацювання - ближче до її верхньої частини
Загалом це можна у вигляді накопичувачів, у яких набори коммітів переміщаються більш стабільний рівень лише після повного тестування.
Малюнок 27. Подання діаграми стабільності гілок як багаторівневого накопичувача
Число рівнів стабільності можна збільшити. У великих проектах найчастіше з'являється гілка proposed або pu (пропоновані оновлення), що об'єднує гілки з вмістом, яке ще не готове до включення next або master . Ідея полягає в тому, що кожна гілка є певним рівнем стабільності; як тільки він підвищується, вміст зливається у гілку рівнем вище. Зрозуміло, можна взагалі обійтися без довголітніх гілок, але часто вони мають сенс, особливо під час роботи над великими та складними проектами.
Тематичні гілки
А ось така річ, як тематичні галузі, корисна незалежно від величини проекту. Тематичною гілкою називається тимчасова гілка, що створюється та використовується для роботи над конкретною функціональною можливістю або вирішення супутніх завдань.Швидше за все, при роботі з іншими системами контролю версій ви ніколи нічого подібного не робили, тому що там створення і злиття гілок - витратні операції. .
Приклад тематичних гілок ви бачили в попередньому розділі, коли ми створювали гілки iss53 і hotfix . — оскільки робота розділена за рівнями і всі зміни в конкретній гілці відносяться до певної теми, що дозволяє легко побачити саме було зроблено під час процедури перегляду коду чи аналогічною.
Припустимо, ми працюємо в гілці master, відгалужуємося для вирішення попутної проблеми (iss91), деякий час займаємося нею, потім створюємо гілку, щоб спробувати вирішити це завдання іншим способом (iss91v2), повертаємося в гілку master і виконуємо там якісь дії, потім створюємо нову гілку для змін, в результаті яких не впевнені (гілка dumbidea). Результуюча історія коммітів виглядатиме приблизно так:
Припустимо, вам більше подобається другий варіант розв'язання задачі ( iss91v2 ), а гілку dumbidea ви показали колегам, і виявилося, що там міститься геніальна ідея. історія виглядатиме так:
Докладніше можливі варіанти робочих схем для проектів розглядаються в розділі Розподілений Git, тому перед вибором схеми обов'язково прочитайте цей розділ.
Важливо пам'ятати, що під час цих маніпуляцій гілки повністю локальні. Розгалуження та злиття виконуються тільки у вашому Git репозиторії — зв'язок із сервером не потрібний.