git tag

Voer de volgende opdracht uit om een nieuwe tag te maken:

Vervang de < tagnaam > door een semantische id voor de status van de repo op het moment dat de tag werd aangemaakt. Een veelgebruikt patroon is het gebruik van versienummers, zoals git tag v1.4. Git ondersteunt twee verschillende soorten tags, geannoteerde en lichte tags. In het vorige voorbeeld is een lichte tag gemaakt. Lichte tags en geannoteerde tags verschillen in de hoeveelheid bijbehorende metagegevens die ze opslaan. Je kunt geannoteerde tags het beste beschouwen als openbaar en lichte tags als privé. Op geannoteerde tags worden extra metagegevens opgeslagen, zoals de naam van de tagger, het e-mailadres en de datum. Dit zijn belangrijke gegevens voor een openbare release. Lichte tags zijn in wezen 'bladwijzers' voor een commit: ze vormen een naam en een verwijzing naar een commit en zijn handig om snelle links naar relevante commits te maken.

Als je deze opdracht uitvoert, wordt een lichte tag gemaakt, met de id v1.4. Lichte tags worden gemaakt zonder de opties -a, -s en -m. Lichte tags maken een nieuwe tag-checksum en slaan deze op in de map .git/ van de repo van het project.

Voer het volgende uit om de opgeslagen tags in een repo weer te geven:

Dit levert een lijst met tags op:

Om de lijst met tags te verfijnen kan de optie -l worden doorgegeven een wildcard-expressie:

In dit vorige voorbeeld wordt de optie -l gebruikt en een wildcard-expressie van -rc, wat een lijst geeft van alle tags die zijn gemarkeerd met het voorvoegsel -rc, wat gewoonlijk wordt gebruikt om kandidaten voor de release te identificeren.

De voorgaande voorbeelden van taggen hebben acties op impliciete commits aangetoond. Standaard zal git tag op de commit een tag aanmaken waarnaar HEAD verwijst. Als alternatief kan de git tag als referentie worden doorgegeven aan een specifieke commit. Hiermee wordt de doorgegeven commit getagd in plaats van standaard HEAD. Voer de opdracht git log uit om een lijst van oudere commits te verzamelen.

Als je een git log uitvoert, krijg je een lijst met commits. In dit voorbeeld kiezen we de meest gecommitte Merge branch 'feature' voor de nieuwe tag. We hebben een verwijzing nodig naar de SHA-hash voor commit om door te geven aan Git:

Door de bovenstaande opdracht van de git tag uit te voeren wordt een nieuwe geannoteerde commit aangemaakt, met de id v1.2, voor de commit die we in het vorige voorbeeld van de git log hebben geselecteerd.

Als je probeert een tag te maken met dezelfde id als een bestaande tag, genereert Git een foutmelding zoals:

Als je bovendien een oudere commit probeert te taggen met een bestaande tag-id, genereert Git dezelfde foutmelding.

In het geval dat je een bestaande tag moet updaten, moet de optie -f FORCE worden gebruikt.

Als je de bovenstaande opdracht uitvoert, wordt de commit 15027957951b64cf874c3557a0f3547bd83b3ff6 toegewezen aan de tag-id v1.4. Dit vervangt alle bestaande content voor de tag v1.4.

Het delen van tags is vergelijkbaar met het pushen van branches. git push pusht standaard geen tags. Tags moeten expliciet worden doorgegeven aan git push.

Geef de optie --tags door aan de opdracht git push om meerdere tags tegelijk te pushen. Wanneer een andere gebruiker een repo kloont of pullt, ontvangt diegene de nieuwe tags.

Je kunt de status van een repo op een tag bekijken door de opdracht git checkout te gebruiken.

Bovenstaande opdracht checkt de tag v1.4 uit. Dit plaatst de repo in een aparte HEAD-status. Dit betekent dat de tag niet wordt bijgewerkt als er wijzigingen worden aangebracht. Hierdoor wordt een nieuw, afzonderlijke commit aangemaakt. Deze nieuwe, afzonderlijke commit maakt geen deel uit van een branch en is enkel rechtstreeks bereikbaar via de SHA-hash van commits. Daarom is het goed om elke keer een nieuwe branch aan te maken als je veranderingen aanbrengt in een aparte HEAD-staat.

Tags verwijderen is heel eenvoudig. Door de optie -d en een tag-id door te geven aan git tag, wordt de geïdentificeerde tag verwijderd.

In dit voorbeeld wordt de git tag uitgevoerd om een lijst met tags weer te geven met v1, v2, v3. Vervolgens wordt de git tag -d v1 uitgevoerd, waardoor de tag v1 wordt verwijderd.

In het kort: taggen is een aanvullend mechanisme dat wordt gebruikt om een momentopname van een Git-repo te maken. Taggen wordt van oorsprong gebruikt om semantische id-tags voor versienummers te maken die overeenkomen met de softwarereleasecycli. De opdracht git tag is de belangrijkste drijfveer van taggen: aanmaken, wijzigen en verwijderen. Er zijn twee soorten tags: geannoteerd en licht. Geannoteerde tags zijn over het algemeen beter omdat ze aanvullende waardevolle metagegevens over de tag opslaan. Andere Git-opdrachten die in dit document aan bod kwamen, waren git push en git checkout. Ga naar de bijbehorende pagina's voor meer informatie over het gebruik ervan.