Come si rinomina un tag Git?

Oggi stavo cercando tra i registri un progetto e mi sono reso conto che un po 'di tempo fa avevo fatto il dito sul nome di un tag. C'è un modo per rinominare il tag? Google non ha rivelato nulla di utile.

Mi rendo conto che potrei controllare la versione taggata e creare un nuovo tag, ci ho persino provato. Ma questo sembra creare un oggetto tag che non è del tutto corretto. Per uno,

git tag -l

lo elenca fuori servizio rispetto a tutti gli altri tag. Non ho idea se sia significativo, ma mi porta a credere che il nuovo oggetto tag non sia esattamente quello che voglio. Posso convivere con quello, perché mi interessa davvero solo che il nome del tag corrisponda alla documentazione, ma preferirei farlo "giusto", supponendo che ci sia un modo giusto per farlo.

Ecco come rinominare un tag oldin new:

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

I due punti nel comando push rimuovono il tag dal repository remoto. Se non lo fai, Git creerà il vecchio tag sul tuo computer quando tiri.

Infine, assicurati che gli altri utenti rimuovano il tag eliminato. Si prega di dire loro (collaboratori) di eseguire il seguente comando:

git pull --prune --tags

Si noti che se si modifica un tag con annotazioni , è necessario assicurarsi che il nome del nuovo tag faccia riferimento al commit sottostante e non al vecchio oggetto tag con annotazione che si sta per eliminare. Pertanto, utilizzare git tag -a new old^{}invece di git tag new old(questo perché i tag con annotazioni sono oggetti mentre i tag leggeri non lo sono, maggiori informazioni in questa risposta ).

La domanda iniziale era come rinominare un tag, che è facile: in primo luogo creare nuovi come alias di OLD: git tag NEW OLDquindi eliminare VECCHIO: git tag -d OLD.

La citazione relativa a "The Git Way" e (in) sanità mentale è off base, perché si tratta di preservare un nome di tag, ma di farlo fare riferimento a un diverso stato del repository.

Oltre alle altre risposte:

Per prima cosa devi creare un alias del vecchio nome del tag, puntando al commit originale:

git tag new old^{}

Quindi è necessario eliminare quello vecchio a livello locale :

git tag -d old

Quindi elimina il tag dalle posizioni remote:

# 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

Infine, devi aggiungere il nuovo tag alla posizione remota. Fino a quando non lo avrai fatto, i nuovi tag non verranno aggiunti:

git push origin --tags

Iterate questo per ogni posizione remota.

Essere consapevoli delle implicazioni che una modifica Git Tag ha per i consumatori di un pacchetto!

Se è pubblicato, non puoi eliminarlo (senza rischiare di essere catramato e piumato, cioè). Il "modo Git" è quello di fare:

La cosa sana di mente. Ammetti di aver sbagliato e di usare un nome diverso. Altri hanno già visto un nome-tag e se mantieni lo stesso nome, potresti trovarti nella situazione in cui due persone hanno entrambe la "versione X", ma in realtà hanno "X" diverse. Quindi chiamalo semplicemente "X.1" e falla finita.

In alternativa,

La cosa folle. Vuoi davvero chiamare anche la nuova versione "X", anche se altri hanno già visto quella vecchia. Quindi usa di nuovo git-tag -f, come se non avessi già pubblicato quello vecchio.

È così folle perché:

Git non cambia (e non dovrebbe) cambiare i tag dietro gli utenti. Quindi, se qualcuno ha già ottenuto il vecchio tag, fare un git-pull sul tuo albero non dovrebbe solo farli sovrascrivere quello vecchio.

Se qualcuno ha ricevuto un tag di rilascio da te, non puoi semplicemente cambiarlo aggiornando il tuo. Questo è un grosso problema di sicurezza, in quanto le persone DEVONO essere in grado di fidarsi dei loro nomi di tag. Se vuoi davvero fare la cosa folle, devi solo farcela e dire alla gente che hai sbagliato.

Tutto per gentile concessione delle pagine man .

Questa pagina wiki ha questo interessante one-liner, che ci ricorda che possiamo spingere diversi ref :

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

e chiedere ad altri clonatori di fare git pull --prune --tags

Quindi l'idea è di spingere:

• <new-tag>per ogni commit a cui fa riferimento <old-tag>> <refs/tags/old-tag>:<refs/tags/new-tag>,
• la cancellazione di<old-tag> ::<refs/tags/old-tag>

Vedi come esempio " Cambia la convenzione di denominazione dei tag all'interno di un repository git? ".

Come aggiunta alle altre risposte, ho aggiunto un alias per fare tutto in un solo passaggio, con una sensazione di comando di spostamento * nix più familiare. L'argomento 1 è il vecchio nome del tag, l'argomento 2 è il nuovo nome del tag.

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

Uso:

git renametag old new

Segui l'approccio in 3 passaggi per uno o alcuni numeri di tag.

Passaggio 1: identificare l'ID commit / oggetto del commit a cui punta il tag corrente

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

Passaggio 2: eliminare il tag dal 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)

Passaggio 3: crea un nuovo tag che punta allo stesso ID commit a cui puntava il vecchio tag

     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>

Una volta che git locale è pronto con la modifica del nome del tag, queste modifiche possono essere riportate all'origine per consentire ad altri di prenderle.

Per gli avventurosi può essere fatto in un solo comando:

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

Indipendentemente dai problemi relativi al push dei tag e alla ridenominazione dei tag che sono già stati inviati, nel caso in cui il tag da rinominare sia annotato , è possibile innanzitutto copiarlo grazie alla seguente riga di comando a riga singola:

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

Quindi, devi solo eliminare il vecchio tag:

git tag -d old_tag

Ho trovato questa riga di comando grazie alle seguenti due risposte:

• https://stackoverflow.com/a/26132640/7009806 (secondo commento)
• https://stackoverflow.com/a/49286861/7009806

Modifica: dopo
aver riscontrato problemi utilizzando la sincronizzazione automatica delle impostazioni dei tag fetch.pruneTags=true(come descritto in https://stackoverflow.com/a/49215190/7009806 ), suggerisco personalmente di copiare prima il nuovo tag sul server e quindi eliminare quello vecchio. In questo modo, il nuovo tag non viene eliminato in modo casuale quando si elimina il vecchio tag e una sincronizzazione dei tag vorrebbe eliminare il nuovo tag che non è ancora sul server . Quindi, per esempio, tutti insieme otteniamo:

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

Puoi anche rinominare i tag remoti senza estrarli, duplicando il vecchio tag / ramo con un nuovo nome ed eliminando quello vecchio, con un solo git pushcomando.

Tag rename remoto / filiale remota → conversione tag: (Avviso: :refs/tags/)

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

Ramo rinominare Remote / tag remoto → conversione ramo: (Avviso: :refs/heads/)

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

Output che rinomina un tag remoto:

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