3.5 Git-grenar - Fjärrgrenar

När du vill dela en gren med omvärlden behöver du skicka den till ett fjärrkodförråd där du har skrivrättigheter. Dina lokala grenar synkroniseras inte automatiskt – du måste skicka de grenar du vill dela. Då kan du ha privata grenar för arbete du inte vill dela och skicka bara de ämnesgrenar du vill samarbeta kring.

Om du har en gren som heter serverfix och vill arbeta med andra kan du skicka den på samma sätt som din första gren. Kör git push <fjärr> <gren>:

Det här är en genväg. Git expanderar automatiskt grennamnet serverfix till refs/heads/serverfix:refs/heads/serverfix, vilket betyder: "Ta min lokala gren serverfix och uppdatera fjärrkodförrådets serverfix-gren". Vi går igenom refs/heads/ i detalj i Git bakom kulisserna, men du kan i regel utelämna det. Du kan också göra git push origin serverfix:serverfix, vilket är samma sak. Detta format låter dig skicka en lokal gren till en fjärrgren med ett annat namn. Om du inte vill kalla den serverfix i fjärrkodförrådet kan du köra git push origin serverfix:awesomebranch för att skicka din lokala serverfix som awesomebranch i fjärrkodförrådet.

Nästa gång en kollega uppdaterar från servern får de en referens till var serverns serverfix ligger, som fjärrgrenen origin/serverfix:

Det är viktigt att notera att när du uppdaterar nya fjärrspårade grenar får du inte automatiskt en lokal, redigerbar kopia av dem. I det här fallet har du alltså ingen ny lokal serverfix-gren – bara en origin/serverfix-pekare som du inte kan ändra.

För att sammanfoga arbetet med din nuvarande gren kan du köra git merge origin/serverfix. Om du vill ha en egen serverfix-gren att jobba i kan du basera den på fjärrspårade grenen:

Detta ger dig en lokal gren att arbeta på som börjar där origin/serverfix ligger.

Att växla till en lokal gren från en fjärrspårad gren skapar automatiskt en "spårande gren" (och grenen den följer kallas "uppströmsgren"). Spårande grenar är lokala grenar med en direkt koppling till en fjärrgren. Om du står på en spårande gren och skriver git pull vet Git automatiskt vilken server den ska hämta från och vilken gren som ska sammanfogas in.

När du klonar ett kodförråd skapas normalt en master-gren som spårar origin/master. Du kan dock skapa andra spårande grenar om du vill – till exempel för grenar i andra fjärrkodförråd eller för att inte spåra master. Det enkla fallet är det du såg nyss, git checkout -b <gren> <fjärr>/<gren>. Det är så vanligt att Git har en kortform: --track.

Det är så vanligt att det till och med finns en genväg till genvägen. Om grenen du försöker växla till (a) inte finns lokalt och (b) exakt matchar en gren i ett enda fjärrkodförråd, skapar Git en spårande gren åt dig:

För att skapa en lokal gren med ett annat namn än fjärrgrenen kan du använda första varianten med ett annat lokalt grennamn:

Nu kommer din lokala gren sf automatiskt att dra från origin/serverfix.

Om du redan har en lokal gren och vill koppla den till en fjärrgren du just uppdaterat, eller byta vilken uppströmsgren den spårar, kan du använda -u eller --set-upstream-to med git branch för att sätta detta när som helst.

Om du vill se vilka spårande grenar du har kan du använda git branch -vv. Det listar dina lokala grenar med mer information, inklusive vad varje gren spårar och om den ligger före, efter eller bådadera.

Här ser vi att iss53 spårar origin/iss53 och ligger "före" med två, vilket betyder att vi har två lokala incheckningar som inte är skickade. Vi ser också att master spårar origin/master och är uppdaterad. serverfix spårar server-fix-good på teamone och ligger före med tre och efter med en, vilket betyder att det finns en incheckning på servern som vi inte har sammanfogat ännu och tre lokala incheckningar som inte är skickade. Slutligen ser vi att testing inte spårar någon fjärrgren.

Det är viktigt att notera att dessa siffror bara gäller sedan senaste gången du uppdaterade från varje server. Kommandot kontaktar inte servrarna utan visar vad som finns i din lokala mellanlagring. Vill du ha helt uppdaterade siffror behöver du uppdatera från alla fjärrkodförråd precis innan du kör det, till exempel så här:

Kommandot git fetch uppdaterar ditt lokala kodförråd med alla ändringar från servern som du inte redan har. Det uppdaterar bara datan och låter dig sammanfoga den själv. git pull är i de flesta fall git fetch följt direkt av git merge. Om du har en spårande gren inställd, antingen genom att du satte den explicit eller för att clone eller checkout skapade den, kommer git pull att slå upp vilken server och gren din nuvarande gren spårar, uppdatera från servern och försöka sammanfoga fjärrgrenen.

Anta att du är klar med en fjärrgren – du och dina kollegor är färdiga med en funktion och har sammanfogat den in i fjärrkodförrådets master (eller den gren där er stabila kodlinje finns). Du kan ta bort en fjärrgren med --delete till git push. Om du vill ta bort serverfix från servern kör du:

Det enda detta gör är i praktiken att ta bort pekaren på servern. Git‑servern behåller oftast data en tid tills skräpsamling körs, så om det togs bort av misstag går det ofta att återställa.