HOWTO · Git

Verschieben Sie ein vorhandenes Tag in Git

Sie können ein vorhandenes Git-Tag auf einen ausgewählten Commit verschieben.

Auf dieser Seite

Ein Git-Tag bezeichnet einen bestimmten Punkt in der Repository-Historie, meistens einen Commit. Sie können ein lokales Tag auf einen ausgewählten Commit verschieben und, wenn das Team zustimmt, auch den Remote-Verweis ersetzen. Stimmen Sie sich ab, bevor Sie ein Tag ändern, das andere für eine Veröffentlichung verwenden: Teammitglieder haben möglicherweise das alte Ziel abgerufen, und automatisierte Builds oder Veröffentlichungsnachweise können davon abhängen.

Git-Tags und die Risiken ihres Verschiebens verstehen

Ein leichtgewichtiges Tag ist ein direkter Verweis auf ein Git-Objekt, meistens einen Commit. Ein annotiertes Tag ist ein eigenes Git-Objekt mit einer Nachricht und Metadaten zum Tag-Ersteller; es kann außerdem signiert sein. Wenn Sie ein Tag ersetzen, ändert sich, auf welches Objekt der Name verweist. Um ein annotiertes Tag neu zu erstellen, müssen Sie dessen Nachricht erneut angeben. Ein signiertes Tag müssen Sie erneut signieren. Das neue Tag-Objekt übernimmt weder das alte Objekt noch dessen Signatur.

Ermitteln Sie vor einer Änderung mit git show --no-patch --format=%H <tag> das aktuelle Ziel des Tags und entscheiden Sie, welcher Commit es ersetzen soll. Geben Sie für das neue Ziel eine Commit-ID oder eine andere explizite Revision an, statt sich auf den gerade ausgecheckten Commit zu verlassen. Wenn das Tag gemeinsam genutzt wird, teilen Sie den Teammitgliedern das vorgesehene neue Ziel mit und weisen Sie darauf hin, dass sie ihre lokale Kopie möglicherweise aktualisieren müssen.

Ein lokales Tag auf einen anderen Commit verschieben

Mit git tag -f <tag> <commit> verschieben Sie ein lokales Tag direkt. Die Option -f ersetzt den vorhandenen lokalen Namen. Erstellen Sie bei einem annotierten Tag die Annotation mit git tag -f -a <tag> <commit> -m "<message>" neu. Wenn das Tag signiert werden muss, verwenden Sie statt -a die Option -s und richten Sie die in Ihrem Repository erforderliche Signierung ein. Behalten Sie, sofern passend, die ursprüngliche Nachricht und die Bedeutung für die Veröffentlichung bei.

Führen Sie dieses Beispiel in einer Shell mit installiertem Git aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

set -eu
repo_dir=$(mktemp -d)
trap 'rm -rf "$repo_dir"' EXIT
git -C "$repo_dir" init -q
git -C "$repo_dir" config user.name "Example User"
git -C "$repo_dir" config user.email "example@example.com"
printf 'first\n' > "$repo_dir/file.txt"
git -C "$repo_dir" add file.txt
git -C "$repo_dir" commit -qm "first commit"
first_commit=$(git -C "$repo_dir" rev-parse HEAD)
git -C "$repo_dir" tag v1.0 "$first_commit"
printf 'second\n' >> "$repo_dir/file.txt"
git -C "$repo_dir" commit -qam "second commit"
target_commit=$(git -C "$repo_dir" rev-parse HEAD)
git -C "$repo_dir" tag -f v1.0 "$target_commit" >/dev/null
tag_commit=$(git -C "$repo_dir" rev-parse refs/tags/v1.0)
if [ "$tag_commit" = "$target_commit" ]; then
  printf 'tag points to intended commit: yes\n'
else
  printf 'tag points to intended commit: no\n'
fi

Ersetzen Sie in Ihrem Repository den Platzhalter durch den tatsächlichen Tag-Namen und Ziel-Commit. Meldet ein einfaches git tag <tag> <commit>, dass das Tag bereits existiert, ist das erwartetes Verhalten: Verwenden Sie die Option zum Erzwingen nur, nachdem Sie das neue Ziel überprüft haben. Die unveränderte Beispielausgabe verwendet englische Bezeichnungen: Sie meldet, ob das Tag auf den vorgesehenen Commit verweist.

Das Remote-Tag aktualisieren

Aktualisieren Sie nach der Abstimmung nur das angegebene Remote-Tag mit git push --force origin <tag>. Dadurch wird der Remote-Verweis für dieses Tag ersetzt. Das macht die Änderung jedoch nicht unproblematisch für Teammitglieder, die noch das bisherige Ziel verwenden. Vermeiden Sie es, alle Tags zu übertragen, wenn Sie nur eines ändern möchten. Weist der Server die Aktualisierung zurück, prüfen Sie die Repository-Berechtigungen und serverseitige Tag-Schutzregeln, statt den Push wiederholt zu erzwingen.

Ein von jemand anderem aktualisiertes Tag abrufen

Wenn jemand anderes das Remote-Tag verschoben hat, verweist Ihr lokales Tag möglicherweise noch auf das frühere Ziel. Rufen Sie das angegebene Tag mit git fetch origin tag <tag> ab. Meldet Git, dass der Abruf das vorhandene lokale Tag überschreiben würde, entfernen Sie diesen lokalen Verweis mit git tag -d <tag> und rufen Sie das angegebene Tag erneut ab. Das Löschen des lokalen Verweises löscht nicht das Remote-Tag. Dieser Fehler unterscheidet sich von einem erfolgreichen Abruf, bei dem ein Verweis unverändert bleibt; ein allgemeines git pull ist kein verlässlicher Ersatz dafür, dieses Tag ausdrücklich abzurufen.

Überprüfen, ob das Tag auf den vorgesehenen Commit verweist

Prüfen Sie den Commit des lokalen Tags mit git rev-parse <tag>^{}. Das Suffix ^{} löst ein annotiertes Tag bis zu dem Commit auf, auf den es letztlich verweist. Vergleichen Sie diese vollständige Commit-ID mit dem vorgesehenen Commit, etwa der von git rev-parse <commit> ausgegebenen ID.

Um das Remote zu prüfen, ohne lokale Verweise zu ändern, führen Sie git ls-remote --tags origin <tag> aus. Dieses Muster wählt das angegebene Tag aus und erfasst auch dessen aufgelösten Verweis. Bei einem annotierten Tag gibt die Zeile mit ^{} den Commit an, auf den das Tag letztlich verweist; vergleichen Sie dessen Commit-ID mit dem vorgesehenen Commit. Wenn ein Teammitglied ein gemeinsam genutztes Tag ändert, teilen Sie das neue Ziel mit, damit alle überprüfen können, ob sie denselben Verweis für die Veröffentlichung verwenden.