git tag

Führe folgenden Befehl aus, um ein neues Tag zu erstellen:

Ersetze < tagname > durch eine semantische Kennung für den Zustand des Repositorys zum Zeitpunkt der Tag-Erstellung. Häufig werden hierfür Versionsnummern wie git tag v1.4 verwendet. Git unterstützt zwei Arten von Tags: annotierte und Lightweight-Tags. Im vorherigen Beispiel wurde ein Lightweight-Tag erstellt. Lightweight-Tags und annotierte Tags unterscheiden sich im Umfang der gespeicherten begleitenden Metadaten. Als Best Practice solltest du annotierte Tags als "öffentlich" und Lightweight-Tags als "privat" betrachten. Bei annotierten Tags werden zusätzliche Metadaten wie der Name und die E-Mail-Adresse des Taggers sowie das Datum gespeichert. Diese Daten sind für öffentliche Releases wichtig. Lightweight-Tags sind im Prinzip "Lesezeichen" für einen Commit und somit nur ein Name und ein Verweis auf einen Commit. Sie eignen sich zur schnellen Erstellung von Links zu relevanten Commits.

Mit diesem Befehl erstellst du ein Lightweight-Tag mit der Kennung v1.4-lw. Beim Erstellen von Lightweight-Tags werden die Optionen -a, -s und -m nicht verwendet. Zusammen mit dem Lightweight-Tag wird eine neue Prüfsumme erstellt und im .git/-Verzeichnis des Projekt-Repositorys gespeichert.

Führe folgenden Befehl aus, um eine Liste der in einem Repository gespeicherten Tags abzurufen:

Hiermit wird eine Liste der Tags ausgegeben:

Wenn du die Liste der Tags eingrenzen möchtest, kannst du die Option -l in Verbindung mit einem Platzhalterausdruck übergeben:

Im Beispiel oben wurde die Option -l zusammen mit dem Platzhalterausdruck -rc verwendet. Die Ausgabe ist eine Liste aller mit dem Präfix -rc versehenen Tags, das üblicherweise zur Kennzeichnung von release candidates (Release-Kandidaten) verwendet wird.

Mit den bisherigen Tagging-Beispielen haben wir Vorgänge für implizite Commits demonstriert. Standardmäßig erstellt git tag ein Tag für den Commit, auf den der HEAD verweist. Alternativ kannst du git tag als Referenz an einen bestimmten Commit übergeben, um den angegebenen Commit statt des HEAD zu taggen. Wenn du eine Liste älterer Commits abrufen möchtest, verwende den Befehl git log.

Die Ausführung von git log gibt eine Liste der Commits aus. In diesem Beispiel wählen wir den obersten Commit Merge branch 'feature' für das neue Tag aus. Wir müssen dazu auf den Commit-SHA-Hash für Git verweisen:

Mit dem oben gezeigten Aufruf des Befehls git tag wird ein neuer annotierter Commit mit der Kennung v1.2 für den Commit erstellt, den wir im vorherigen git log-Beispiel ausgewählt haben.

Wenn du versuchst, ein Tag mit derselben Kennung wie bei einem bereits vorhandenen Tag zu erstellen, gibt Git einen Fehler aus. Die Meldung lautet in etwa:

Solltest du versuchen, einen älteren Commit mit einer vorhandenen Tag-Kennung zu taggen, gibt Git denselben Fehler aus.

Wenn du ein vorhandenes Tag aktualisieren musst, ist dies nur mit der Option -f (FORCE) möglich.

Mit dem Befehl oben wird der Commit 15027957951b64cf874c3557a0f3547bd83b3ff6 der Tag-Kennung v1.4 zugeordnet. Vorhandene Inhalte des Tags v1.4 werden dabei überschrieben.

Das Freigeben von Tags funktioniert ähnlich wie das Pushen von Branches. Standardmäßig werden mit git push keine Tags gepusht. Tags müssen explizit an git push übergeben werden.

Wenn du mehrere Tags gleichzeitig pushen möchtest, verwende die Option --tags für den Befehl git push. Wenn nun ein anderer Benutzer ein Repository klont oder pullt, erhält er die neuen Tags.

Mit dem Befehl git checkout kannst du an einem Tag den Status eines Repositorys abrufen.

Mit dem oben verwendeten Befehl wird das Tag v1.4 ausgecheckt. Dadurch wechselt das Repository in einen Status mit losgelöstem HEAD. Vorgenommene Änderungen führen dann nicht zu einer Aktualisierung des Tags. Stattdessen wird ein neuer losgelöster Commit erstellt. Dieser neue losgelöste Commit ist nicht Teil eines Branch und nur über den SHA-Hash des Commits zu erreichen. Aus diesem Grund empfiehlt es sich, immer einen neuen Branch zu erstellen, wenn du im Status mit losgelöstem HEAD Änderungen vornimmst.

Das Löschen von Tags ist einfach: Du musst nur die Option -d und eine Tag-Kennung an git tag übergeben, um das entsprechende Tag zu löschen.

In diesem Beispiel haben wir mit git tag eine Liste der Tags mit v1, v2 und v3 aufgerufen. Mit git tag -d v1 haben wir dann das v1-Tag gelöscht.

Zusammenfassend lässt sich festhalten: Das Taggen ist ein weiterer Mechanismus zum Erstellen eines Snapshots von einem Git-Repository. Üblicherweise werden dabei Tags als semantische Kennung einer Versionsnummer erstellt, die Software-Release-Zyklen entsprechen. Der Befehl git tag ist der Hauptbefehl für das Erstellen, Ändern und Löschen von Tags. Es gibt zwei Arten von Tags: annotierte und Lightweight-Tags. Annotierte Tags sind generell eher zu empfehlen, weil darin wertvolle zusätzliche Metadaten zum Tag gespeichert werden. In diesem Dokument wurden außerdem die Git-Befehle git push und git checkout behandelt. Auf den entsprechenden Seiten findest du Hinweise zur erweiterten Nutzung dieser Befehle.