Wie benennt man ein Git-Tag um?

Heute habe ich in den Protokollen nach einem Projekt gesucht und festgestellt, dass ich vor einiger Zeit einen Tag-Namen fett gefingert habe. Gibt es eine Möglichkeit, das Tag umzubenennen? Google hat nichts Nützliches gefunden.

Mir ist klar, dass ich die getaggte Version auschecken und ein neues Tag erstellen kann, das habe ich sogar versucht. Aber das scheint ein Tag-Objekt zu erzeugen, das nicht ganz richtig ist. Für einen,

git tag -l

listet es in Bezug auf alle anderen Tags in der falschen Reihenfolge auf. Ich habe keine Ahnung, ob das von Bedeutung ist, aber es lässt mich glauben, dass das neue Tag-Objekt nicht ganz das ist, was ich will. Ich kann damit leben, weil es mir wirklich nur wichtig ist, dass der Tag-Name mit der Dokumentation übereinstimmt, aber ich würde es lieber "richtig" machen, vorausgesetzt, es gibt einen richtigen Weg, dies zu tun.

So benenne ich ein Tag um oldin new:

git tag new old
git tag -d old
git push origin :refs/tags/old
git push --tags

Der Doppelpunkt im Push-Befehl entfernt das Tag aus dem Remote-Repository. Wenn Sie dies nicht tun, erstellt Git beim Ziehen das alte Tag auf Ihrem Computer.

Stellen Sie schließlich sicher, dass die anderen Benutzer das gelöschte Tag entfernen. Bitte fordern Sie sie (Mitarbeiter) auf, den folgenden Befehl auszuführen:

git pull --prune --tags

Beachten Sie, dass Sie beim Ändern eines mit Anmerkungen versehenen Tags sicherstellen müssen, dass der neue Tag-Name auf das zugrunde liegende Commit verweist und nicht auf das alte mit Anmerkungen versehene Tag-Objekt, das Sie löschen möchten. Verwenden Sie daher git tag -a new old^{}anstelle von git tag new old(Dies liegt daran, dass mit Anmerkungen versehene Tags Objekte sind, während Lightweight-Tags dies nicht sind. Weitere Informationen finden Sie in dieser Antwort ).

Die ursprüngliche Frage war, wie ein Tag umbenannt werden kann, was einfach ist: Erstellen Sie zuerst NEW als Alias ​​von OLD: git tag NEW OLDLöschen Sie dann OLD:git tag -d OLD .

Das Zitat in Bezug auf "den Git-Weg" und (In-) Vernunft ist falsch, da es darum geht, einen Tag-Namen beizubehalten, ihn jedoch auf einen anderen Repository-Status verweisen zu lassen.

Neben den anderen Antworten:

Zuerst müssen Sie einen Alias des alten Tag-Namens erstellen , der auf das ursprüngliche Commit verweist:

git tag new old^{}

Dann müssen Sie die alte lokal löschen :

git tag -d old

Löschen Sie dann das Tag an Ihren Remote-Standorten:

# Check your remote sources:
git remote -v
# The argument (3rd) is your remote location,
# the one you can see with `git remote`. In this example: `origin`
git push origin :refs/tags/old

Schließlich müssen Sie Ihr neues Tag zum Remotestandort hinzufügen. Bis Sie dies getan haben, werden die neuen Tags nicht hinzugefügt:

git push origin --tags

Iterieren Sie dies für jeden entfernten Standort.

Beachten Sie die Auswirkungen einer Git-Tag-Änderung auf die Verbraucher eines Pakets!

Wenn es veröffentlicht ist, können Sie es nicht löschen (ohne zu riskieren, dass es geteert und gefiedert wird). Der 'Git Weg' ist zu tun:

Das Vernünftige. Gib einfach zu, dass du es vermasselt hast und benutze einen anderen Namen. Andere haben bereits einen Tag-Namen gesehen, und wenn Sie den gleichen Namen behalten, befinden Sie sich möglicherweise in der Situation, dass zwei Personen beide "Version X" haben, aber tatsächlich unterschiedliche "X". Nennen Sie es einfach "X.1" und fertig.

Alternative,

Das Wahnsinnige. Sie möchten die neue Version auch wirklich "X" nennen, obwohl andere die alte bereits gesehen haben. Verwenden Sie also einfach git-tag -f erneut, als hätten Sie das alte noch nicht veröffentlicht.

Es ist so verrückt, weil:

Git ändert (und sollte es auch nicht) Tags hinter den Benutzern zurück. Wenn also jemand bereits das alte Etikett hat, sollte ein Git-Pull an Ihrem Baum nicht dazu führen, dass er das alte überschreibt.

Wenn jemand ein Release-Tag von Ihnen erhalten hat, können Sie das Tag nicht einfach ändern, indem Sie Ihr eigenes aktualisieren. Dies ist ein großes Sicherheitsproblem, da die Benutzer ihren Tag-Namen vertrauen müssen. Wenn du wirklich das Wahnsinnige tun willst, musst du dich nur damit abfinden und den Leuten sagen, dass du es vermasselt hast.

Mit freundlicher Genehmigung der Manpages .

Diese Wiki-Seite hat diesen interessanten Einzeiler, der uns daran erinnert, dass wir mehrere Refs pushen können :

git push origin <refs/tags/old-tag>:<refs/tags/new-tag> :<refs/tags/old-tag> && git tag -d <old-tag>

und andere Kloner bitten, dies zu tun git pull --prune --tags

Die Idee ist also zu pushen:

• <new-tag>für alle Commits, auf die verwiesen wird von <old-tag> : <refs/tags/old-tag>:<refs/tags/new-tag>,
• die Streichung von<old-tag> ::<refs/tags/old-tag>

Siehe als Beispiel " Namenskonvention von Tags in einem Git-Repository ändern? ".

Als Ergänzung zu den anderen Antworten habe ich einen Alias ​​hinzugefügt, um alles in einem Schritt zu erledigen, mit einem vertrauten Gefühl des * nix-Bewegungsbefehls. Argument 1 ist der alte Tag-Name, Argument 2 ist der neue Tag-Name.

[alias]
    renameTag = "!sh -c 'set -e;git tag $2 $1; git tag -d $1;git push origin :refs/tags/$1;git push --tags' -"

Verwendungszweck:

git renametag old new

Befolgen Sie den dreistufigen Ansatz für ein oder mehrere Tags.

Schritt 1: Identifizieren Sie die Commit- / Objekt-ID des Commits, auf das das aktuelle Tag zeigt

     command: git rev-parse <tag name>
     example: git rev-parse v0.1.0-Demo
     example output: db57b63b77a6bae3e725cbb9025d65fa1eabcde

Schritt 2: Löschen Sie das Tag aus dem Repository

     command: git tag -d <tag name>
     example: git tag -d v0.1.0-Demo
     example output: Deleted tag 'v0.1.0-Demo' (was abcde)

Schritt 3: Erstellen Sie ein neues Tag, das auf dieselbe Commit-ID verweist, auf die das alte Tag zeigte

     command: git tag -a <tag name>  -m "appropriate message" <commit id>
     example: git tag -a v0.1.0-full  -m "renamed from v0.1.0-Demo" db57b63b77a6bae3e725cbb9025d65fa1eabcde
     example output: Nothing or basically <No error>

Sobald der lokale Git mit der Änderung des Tag-Namens fertig ist, können diese Änderungen an den Ursprung zurückgeschoben werden, damit andere sie übernehmen können.

Für die Abenteuerlustigen kann es in einem Befehl ausgeführt werden:

mv .git/refs/tags/OLD .git/refs/tags/NEW

Unabhängig von den Problemen beim Verschieben von Tags und beim Umbenennen von Tags, die bereits verschoben wurden, können Sie das zu umbenennende Tag, falls es sich um ein kommentiertes Tag handelt, zunächst mithilfe der folgenden einzeiligen Befehlszeile kopieren:

git tag -a -m "`git cat-file -p old_tag | tail -n +6`" new_tag old_tag^{}

Dann müssen Sie nur noch das alte Tag löschen:

git tag -d old_tag

Ich habe diese Befehlszeile dank der folgenden zwei Antworten gefunden:

• https://stackoverflow.com/a/26132640/7009806 (zweiter Kommentar)
• https://stackoverflow.com/a/49286861/7009806

Bearbeiten:
Nachdem Probleme bei der automatischen Synchronisierung der Tag-Einstellungen aufgetreten sind fetch.pruneTags=true(wie unter https://stackoverflow.com/a/49215190/7009806 beschrieben ), empfehle ich persönlich, zuerst das neue Tag auf den Server zu kopieren und dann das alte zu löschen. Auf diese Weise wird das neue Tag beim Löschen des alten Tags nicht zufällig gelöscht, und eine Synchronisierung der Tags möchte das neue Tag löschen, das sich noch nicht auf dem Server befindet . So bekommen wir zum Beispiel alle zusammen:

git tag -a -m "`git cat-file -p old_tag | tail -n +6`" new_tag old_tag^{}
git push --tags
git tag -d old_tag
git push origin :refs/tags/old_tag

Sie können Remote-Tags auch umbenennen, ohne sie auszuchecken, indem Sie das alte Tag / den alten Zweig in einen neuen Namen duplizieren und den alten in einem einzigen löschen git push .

Remote - Tag Umbenennungs / Remote Zweig → Tag Umwandlung: (Hinweis: :refs/tags/)

git push <remote_name> <old_branch_or_tag>:refs/tags/<new_tag> :<old_branch_or_tag>

Remote - Zweig Umbenennungs / Remote - Tag → Zweig Umwandlung: (Hinweis: :refs/heads/)

git push <remote_name> <old_branch_or_tag>:refs/heads/<new_branch> :<old_branch_or_tag>

Ausgabe zum Umbenennen eines Remote-Tags:

D:\git.repo>git push gitlab App%2012.1%20v12.1.0.23:refs/tags/App_12.1_v12.1.0.23 :App%2012.1%20v12.1.0.23

Total 0 (delta 0), reused 0 (delta 0)
To https://gitlab.server/project/repository.git
 - [deleted]               App%2012.1%20v12.1.0.23
 * [new tag]               App%2012.1%20v12.1.0.23 -> App_12.1_v12.1.0.23