2.6 Grunder i Git - Taggning

Att list existerande taggar i Git är rättframt. Skriv bara git tag (med valfri -l eller --list):

Kommandot listar taggarna i alfabetisk ordning; ordningen i vilken de står spelar ingen roll.

Du kan också söka efter taggar som matchar ett specifikt mönster. Gits eget källkodsförvar innehåller till exempel mer än 500 taggar. Om du är intresserad av serien 1.8.5 kan du göra såhär:

Git stödjer två typer av taggar: lättviktig och kommenterad.

En lättviktig tagg är väldigt lik en gren som inte ändras — det är bara en pekare till en specifik ögonblicksbild/version.

Kommenterade taggar däremot, sparas som fullvärdiga objekt i Git-databasen. De förses med en checksumma; innehåller namnet på den som taggat, e-post och tidsstämpel; har ett taggningsmeddelande och kan signeras med GNU Privacy Guard (GPG). Generellt rekommenderas att du skapar en kommenterad tagg så att du kan ha all denna information, men om du bara vill ha en temporär tagg eller av någon anledning inte vill ha informationen, så kan du använda lättviktiga taggar.

Att skapa en kommenterad tagg i Git är enkelt. Enklast är att specificera -a när du kör kommandot tag:

Flaggan -m specificerar taggningsmeddelandet som sparas tillsamans med taggen. Om du inte specificerar ett meddelande för din kommenterade tagg, startar Git din editor så att du kan skriva in det.

Du kan se taggdata tillsammans med ögonblicksbilden som blev taggad genom kommandot git show:

Den visar tagginformation, tidsstämpeln för då ögonblicksbilden taggades, och meddelandet innan den visar informationen om ögonblicksbilden.

Ett annat sätt att tagga ögonblicksbilder är en lättviktig tagg. Det är i grunden checksumman för ögonblicksbilden sparad i en fil — ingen annan information sparas. För att skapa en lättviktig tagg, så utelämnar du bara växlarna -a, -s, eller -s, ange bara ett taggnamn:

Om du denna gång kör git show på taggen så kommer du inte se någon extra tagginformation. Kommandot visar bara ögonblicksbilden:

Du kan även tagga ögonblicksbilder efter att du flyttat förbi dem. Anta att din versionshistorik ser ut såhär:

Anta att du glömt tagga projetet vid v1.2 som var vid versionen “updated rakefile”. Du kan lägga till den efteråt. För att tagga den ögonblicksbilden, så specificerar du checksumman (eller en del av den) i slutet av kommandot:

Du kan nu se att versionen blivit taggad:

Normalt skickas inte taggar till fjärrförvar när du kör git push. Du måste uttryckligen skicka upp taggar till en delad server efter att du skapat dem. Processen är densamma som för att dela fjärrgrenar — du kan köra git push origin <tagname>.

Om du har många taggar som du vill skicka upp samtidig, kan du också ange växeln --tags till kommandot git push. Detta kommer att skicka alla dina taggar till servern som inte redan finns där.

Nu, om någon annan klonar eller hämtar hem data från fjärrförvaret kommer de få med dina taggar också.

För att ta bort taggar i ditt lokala förvar så använder du git tag -d <tagname>. Du kan till exempel ta bort vår lättviktiga tagg såhär:

Notera att detta inte tar bort taggen från några fjärrförvar. Det finns två vanliga sätt att ta boort taggar från fjärrförvar.

Den första sättet är git push <fjärrnamn> :refs/tags/<taggnamn>:

Ovanstående skall tolkas som att null-värdet före kolonet skickas till serverns taggnamn, vilket i praktiken tar bort taggen.

Det andra (och mer intiutiva) sättet att ta bort en tagg i fjärrförvaret är med:

Om du vill visa versionenra av filerna som en tagg pekar på kan du köra git checkout på den taggen. Ditt förvar försätts då i tillståndet “detached HEAD”, som har några bieffekter:

I tillståndet “detached HEAD” kan du göra ändringar och spara versioner som vanligt, men taggen kommer inte att ändras och dina sparade versioner kommer inte att tillhöra någon gren och därför vara praktiskt onåbara, förutom via sina checksummor. Så om du vill göra ändringar — till exempel fixa en bugg i en gammal version — så vill du skapa en gren:

Om du gör detta och sedan sparar en version, kommer din gren version2 att skilja sig från din tagg v2.0.0 eftersom den kommer att flyttas fram tillsammans med dina ändringar, så var försiktig.