7.12 Git-verktyg - Bunta

Även om vi har gått igenom de vanliga sätten att överföra Git‑data över nätverk (HTTP, SSH, osv.) finns det faktiskt ytterligare ett sätt som inte används så ofta men kan vara riktigt användbart.

Git kan "bunta" sin data till en enda fil. Det kan vara användbart i olika scenarier. Kanske ligger nätverket nere och du vill skicka ändringar till dina kollegor. Kanske jobbar du på annan ort och har inte åtkomst till det lokala nätverket av säkerhetsskäl. Kanske gick ditt trådlösa nätverkskort eller ethernetkort sönder. Kanske har du för tillfället ingen delad server, du vill skicka någon uppdateringar via e-post och du vill inte skicka 40 incheckningar via format-patch.

Det är här kommandot git bundle kan vara till hjälp. Kommandot git bundle buntar ihop allt som normalt skulle skickas över tråden med kommandot git push i en binärfil som du kan skicka via e-post till någon eller lägga på ett USB‑minne, och sedan packa upp i ett annat kodförråd.

Låt oss se ett enkelt exempel. Säg att du har ett kodförråd med två incheckningar:

Om du vill skicka det kodförrådet till någon och du inte har åtkomst till ett kodförråd att skicka till, eller helt enkelt inte vill sätta upp ett, kan du bunta det med git bundle create.

Nu har du en fil som heter repo.bundle som innehåller all data som behövs för att återskapa kodförrådets master‑gren. Med kommandot git bundle måste du lista varje referens eller specifikt incheckningsintervall som du vill inkludera. Om du vill att det ska kunna klonas någon annanstans bör du också lägga till HEAD som referens, precis som vi gjorde här.

Du kan skicka filen repo.bundle via e-post till någon annan eller lägga den på ett USB‑minne och bära över.

På andra sidan, säg att du får filen repo.bundle och vill arbeta med projektet. Du kan klona från den binära filen till en katalog, ungefär som du skulle från en URL.

Om du inte inkluderar HEAD i referenserna måste du också ange -b master eller vilken gren som än ingår, eftersom den annars inte vet vilken gren den ska växla till.

Säg nu att du gör tre incheckningar där och vill skicka de nya incheckningarna tillbaka via en bunt på ett USB‑minne eller via e-post.

Först behöver vi bestämma intervallet av incheckningar vi vill inkludera i bunten. Till skillnad från nätverksprotokollen som räknar ut minsta mängden data att överföra åt oss måste vi räkna ut detta manuellt. Du kan förstås göra samma sak och bunta hela kodförrådet, vilket fungerar, men det är bättre att bara bunta skillnaden — bara de tre incheckningar vi just gjorde lokalt.

För att göra det behöver du beräkna skillnaden. Som vi beskrev i Incheckningsintervall kan du ange ett incheckningsintervall på flera sätt. För att få de tre incheckningarna som vi har i vår master‑gren men inte i grenen vi ursprungligen klonade kan vi använda något som origin/master..master eller master ^origin/master. Du kan testa det med kommandot log.

Så nu när vi har listan över incheckningar vi vill inkludera i bunten, låt oss bunta dem. Vi gör det med kommandot git bundle create, där vi anger filnamnet vi vill att bunten ska ha och intervallet av incheckningar vi vill stoppa in.

Nu har vi en fil commits.bundle i vår katalog. Om vi tar den och skickar den till vår partner kan hon importera den i det ursprungliga kodförrådet, även om mer arbete har gjorts där under tiden.

När hon får bunten kan hon inspektera den för att se vad den innehåller innan hon importerar den i sitt kodförråd. Det första kommandot är git bundle verify, som säkerställer att filen faktiskt är en giltig Git‑bunt och att du har alla nödvändiga anfäder för att återskapa den korrekt.

Om den som buntade hade skapat en bunt av bara de två senaste incheckningarna de gjorde, i stället för alla tre, skulle det ursprungliga kodförrådet inte kunna importera den, eftersom nödvändig historik saknas. Kommandot verify skulle ha sett ut så här i stället:

Vår första bunt är dock giltig, så vi kan uppdatera med incheckningar från den. Om du vill se vilka grenar som finns i bunten och kan importeras finns också ett kommando för att bara lista huvudena:

Underkommandot verify talar också om huvudena. Poängen är att se vad som kan dras in, så du kan använda kommandona fetch eller pull för att importera incheckningar från den här bunten. Här uppdaterar vi master‑grenen från bunten till en gren som heter other-master i vårt kodförråd:

Nu kan vi se att vi har de importerade incheckningarna på grenen other-master samt eventuella incheckningar vi gjort under tiden i vår egen master‑gren.

Så git bundle kan vara riktigt användbart för att dela eller göra nätverksliknande operationer när du inte har rätt nätverk eller delat kodförråd för att göra det.