3.2 Veje Git - Osnove vej in združevanja

Za začetek recimo, da delate na svojem projektu in imate že nekaj potrditev na veji master.

Odločili ste se, da boste delali na težavi #53 kateregakoli sistema sledenja težav, ki ga vaše podjetje uporablja. Da ustvarite vejo in istočasno nanjo preklopite, lahko poženete ukaz git checkout s stikalom -b:

To je bližnjica za:

Delate na svoji spletni strani in naredite nekaj potrditev. S tem se veja iss53 premakne naprej, ker ste jo izvlekli (to pomeni, da vaš HEAD kaže nanjo):

Sedaj dobite klic, da je težava s spletno stranjo in jo morate takoj popraviti. Z Gitom vam ni treba postaviti vašega popravka skupaj s spremembami iss53, ki ste jih naredili, in ni vam treba vložiti veliko napora v povračanje teh sprememb, preden lahko delate na nameščanju svojega popravka na to, kar je v produkciji. Vse kar morate narediti, je preklopiti nazaj na vašo vejo master.

Vendar preden to naredite, pomnite, da če ima vaš delovni direktorij ali področje priprave nepotrjene spremembe, ki so v konfliktu z vejo, ki jo izvlečete, vam Git ne bo dovolil preklopiti vej. Ko preklapljate veje, je najbolje imeti čisto delovno stanje. Obstajajo načini, da se temu izognete (v glavnem, shranjevanje na varno in potrjevanje sprememb), kar bomo pokrili kasneje v Shranjevanje na varno (angl. stashing) in čiščenje. Za sedaj predpostavimo, da ste potrdili vse svoje spremembe, tako da lahko preklopite nazaj na vašo vejo master:

Na tej točki je vaš delovni direktorij projekta točno tak, kakor je bil preden, ste začeli delati na težavi #53 in sedaj se lahko osredotočite na svoj hitri popravek. To je pomembna točka za zapomniti: ko preklapljate veje, Git ponastavi vaš delovni direktorij, da je videti tako, kot je, ko ste zadnjič naredili potrditev na tej veji. Avtomatično doda, odstrani in spremeni datoteke, da zagotovi, da je vaša delovna kopija taka, kot je bila veja na vaši zadnji potrditvi na njej.

Naslednje morate narediti hitri popravek. Ustvarimo vejo hitrega popravka hotfix, na kateri delate, dokler ni končan:

Poženete lahko svoje teste, zagotovite, da je hitri popravek, kakršen ga želite, in na koncu združite vejo hotfix nazaj v vašo vejo master, da postavite na produkcijo. To naredite z ukazom git merge:

V tej združitvi boste opazili frazo »fast-forward« (hitro previjanje naprej). Ker je potrjevanje C4, kamor kaže veja hotfix, ki ste jo združili, neposredno pred potrditvijo `C2, na kateri ste, Git enostavno premakne kazalec naprej. Povedano drugače, ko poskušate združiti eno potrditev z drugo, ki je lahko dosegljiva s sledenjem zgodovine prve potrditve, Git poenostavi stvari, tako da prestavi kazalec naprej, ker ni nobenega različnega dela za združiti skupaj — to se imenuje »fast-forward«.

Vaša sprememba je sedaj v posnetku potrditve, ki kaže na vejo master, in programski popravek lahko postavite.

Ko je vaš zelo pomemben hitri programski popravek postavljen, ste pripravljeni preklopiti nazaj k delu, ki ste ga delali, preden so vas zmotili. Vendar najprej boste izbrisali vejo hotfix, ker je ne potrebujete več — veja master kaže na isto mesto. Izbrišete jo lahko z možnostjo -d ukazu git branch:

Sedaj lahko vaše delo preklopite nazaj na vašo vejo dela v teku na težavi #53 in nadaljujete delo na njej.

Tu je vredno omeniti, da delo, ki ste ga naredili na vaši veji hotfix, ni vsebovano v datotekah vaše veje iss53. Če ga morate povleči notri, lahko združite vašo vejo master v vašo vejo iss53 s pogonom git merge master ali pa lahko počakate, da integrirate te spremembe, dokler se kasneje ne odločite povleči veje iss53 nazaj v master.

Predpostavimo, da ste se odločili, da je vaša težava #53 končana in pripravljena na združitev v vašo vejo master Da to naredite, boste združili vašo vejo iss53 v master, tako kot ste prej združili vašo vejo hotfix. Vse kar morate narediti, je izvleči vejo, ki jo želite združiti, in nato pognati ukaz git merge:

To je nekoliko drugače kot združitev hotfix, kar ste naredili prej. V tem primeru se je vaša zgodovina razvoja oddaljila od neke starejše točke. Ker potrditev na veji, na kateri ste, ni neposredni prednik veje, ki jo združujete, mora Git narediti nekaj dela. V tem primeru Git naredi enostavno tri-načinsko združitev z uporabo dveh posnetkov, ki kažeta na vrhova vej in skupnega prednika od teh dveh.

Namesto samo premikanja kazalca veje naprej, Git ustvari nov posnetek, ki izhaja iz te tri-načinske združitve in avtomatično ustvari novo potrditev, ki kaže nanjo. Ta se imenuje kot potrditev združitve in je posebna v tem, da ima več kot samo eno nadrejeno.

Sedaj, ko je vaše delo združeno, nimate več potrebe po veji iss53. Težavo lahko zaprete v svojem sistemu sledenja težav in vejo izbrišete:

Občasno ta proces ne gre gladko. Če ste spremenili isti del neke datoteke na različna načina v dveh vejah, ki ju združujete skupaj, jih Git ne bo mogel gladko združiti. Če je vaš programski popravek za težavo #53 spremenil isti del datoteke kot veja hotfix, boste dobili konflikt združevanja, ki je videti nekako takole:

Git ni avtomatično ustvaril potrditve združevanja. Ustavil je proces, dokler ne rešite konflikta. Če želite videti, katere datoteke niso združene na katerikoli točki po konfliktu združevanja, lahko poženete git status:

Karkoli, kar ima konflikte združevanja in niso bili rešeni, je izpisano kot nezdruženo. Git doda standardne označevalce reševanja konfliktov v datoteke, ki imajo konflikte, tako da jih lahko odprete ročno in rešite te konflikte. Vaša datoteka vsebuje razdelek, ki je videti nekako takole:

To pomeni, da je različica v HEAD (vaše veje master, ker ta je bila, kar ste izvlekli, ko ste pognali svoj ukaz združevanja) vrhnji del tega bloka (vse nad =======), medtem ko je različica v vaši veji iss53 videti kot ves spodnji del. Da rešite konflikt, morate izbrati eno ali drugo stran ali pa združiti vsebino sami. Na primer ta konflikt lahko rešite z zamenjavo celotnega bloka s tem:

Ta rešitev ima malo vsake od obeh razdelkov in vrstice <<<<<<<, ======= in >>>>>>> so bile v celoti odstranjene. Ko ste rešili vsakega od teh razdelkov v vsaki konfliktni datoteki, poženite git add na vsaki datoteki, da jo označite kot rešeno. Dajanje datoteke v področje priprave jo v Gitu označi kot rešeno.

Če želite uporabiti grafično orodje, da rešite te težave, lahko poženete git mergetool, ki zažene ustrezno vizualno združevalno orodje in vas pelje na sprehod skozi konflikte:

Če želite namesto privzetega uporabiti drugo orodje združevanja (Git je v tem primeru izbral opendiff, ker je bil ukaz pognan na macOS), lahko pogledate vsa podprta orodja izpisana na vrhu za »one of the following tools«. Samo vpišite ime orodja, ki bi ga raje uporabljali.

Ko zapustite orodje združevanja, vas Git vpraša, ali je bila združitev uspešna. Če skriptu poveste, da je bila, da datoteko v področje priprave in jo tako za vas označi kot rešeno. Ponovno lahko poženete git status, da potrdite, ali so bili vsi konflikti rešeni:

Če ste s tem zadovoljni in potrdite, da je bilo dano v področje priprave vse, kar je imelo konflikte, lahko vpišete git commit, da končate potrditev združevanja. Sporočilo potrditve privzeto je videti nekako takole:

Če mislite, da bi bilo koristno za druge, ki bodo nekoč gledali to združevanje, lahko to sporočilo potrditve spremenite s podrobnostmi o tem, kako ste rešili združevanje in razložite, zakaj ste naredili te spremembe, če te niso očitne.