Como você renomeia uma tag Git?

Hoje eu estava procurando nos logs um projeto e percebi que havia digitado o nome de uma tag há algum tempo. Existe alguma maneira de renomear a tag? O Google não encontrou nada útil.

Sei que pude verificar a versão marcada e criar uma nova tag, até tentei isso. Mas isso parece criar um objeto de tag que não está certo. Para um,

git tag -l

lista fora de ordem em relação a todas as outras tags. Não tenho idéia se isso é significativo, mas isso me leva a acreditar que o novo objeto de tag não é exatamente o que eu quero. Eu posso viver com isso, porque realmente me importo apenas que o nome da tag corresponda à documentação, mas prefiro fazê-lo "certo", assumindo que haja uma maneira correta de fazer isso.

Aqui está como renomeio uma tag oldpara new:

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

Os dois pontos no comando push removem a marca do repositório remoto. Se você não fizer isso, o Git criará a tag antiga na sua máquina quando você puxar.

Por fim, verifique se os outros usuários removem a tag excluída. Diga a eles (colegas de trabalho) para executar o seguinte comando:

git pull --prune --tags

Observe que, se você estiver alterando uma tag anotada , precisará garantir que o novo nome da tag esteja referenciando a confirmação subjacente e não o antigo objeto de tag anotada que você está prestes a excluir. Portanto, use em git tag -a new old^{}vez de git tag new old(isso ocorre porque as tags anotadas são objetos e as tags leves não, mais informações nesta resposta ).

A pergunta original era como renomear uma tag, o que é fácil: primeiro crie NEW como um apelido de OLD: git tag NEW OLDdepois exclua OLD:git tag -d OLD .

A citação sobre "o caminho do Git" e a (in) sanidade está fora da base, porque se trata de preservar um nome de marca, mas fazendo com que se refira a um estado de repositório diferente.

Além das outras respostas:

Primeiro, você precisa criar um alias do nome da tag antiga , apontando para o commit original:

git tag new old^{}

Então você precisa excluir o antigo localmente :

git tag -d old

Em seguida, exclua a tag em seus locais remotos:

# 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

Finalmente, você precisa adicionar sua nova tag ao local remoto. Até você fazer isso, as novas tags não serão adicionadas:

git push origin --tags

Repita isso para todos os locais remotos.

Esteja ciente das implicações que uma alteração no Git Tag tem para os consumidores de um pacote!

Se for publicado, você não poderá excluí-lo (sem correr o risco de ser asfaltado e difuso). A 'maneira Git' é fazer:

A coisa são. Apenas admita que você errou e use um nome diferente. Outros já viram um nome de tag e, se você mantiver o mesmo nome, pode estar na situação em que duas pessoas têm a "versão X", mas na verdade têm "X" diferentes. Então, basta chamá-lo de "X.1" e terminar com isso.

Alternativamente,

A coisa louca. Você realmente deseja chamar a nova versão de "X" também, mesmo que outros já tenham visto a antiga. Portanto, basta usar git-tag -f novamente, como se você não tivesse publicado o antigo.

É tão insano porque:

O Git não altera (e não deve) alterar as tags nas costas dos usuários. Portanto, se alguém já recebeu a etiqueta antiga, dar um puxão na sua árvore não deve fazê-la substituir a antiga.

Se alguém recebeu uma etiqueta de liberação de você, você não pode simplesmente alterá-la atualizando a sua. Esse é um grande problema de segurança, pois as pessoas DEVEM confiar em seus nomes de tags. Se você realmente quer fazer a coisa insana, precisa apenas confessar e dizer às pessoas que você errou.

Toda cortesia das páginas de manual .

Esta página da wiki possui uma linha interessante, que nos lembra que podemos enviar várias referências :

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

e pedir a outros clonadores para fazer git pull --prune --tags

Portanto, a ideia é pressionar:

• <new-tag>para cada commits referenciados por <old-tag>: <refs/tags/old-tag>:<refs/tags/new-tag>,
• a exclusão de<old-tag> ::<refs/tags/old-tag>

Veja como um exemplo " Alterar a convenção de nomenclatura de tags dentro de um repositório git? ".

Como um complemento para as outras respostas, adicionei um alias para fazer tudo em uma única etapa, com uma sensação mais familiar do comando * nix move. Argumento 1 é o nome da marca antiga, argumento 2 é o novo nome da marca.

[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

Siga a abordagem em três etapas para um ou alguns números de tags.

Etapa 1: Identifique o ID do objeto / confirmação do commit que a tag atual está apontando

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

Etapa 2: excluir a tag do repositório

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

Etapa 3: crie uma nova tag apontando para o mesmo ID de confirmação que a tag antiga estava apontando para

     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>

Quando o git local estiver pronto com a alteração do nome da tag, essas alterações poderão ser enviadas de volta à origem para que outras pessoas as aceitem.

Para os aventureiros, isso pode ser feito em um comando:

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

Independentemente dos problemas relacionados ao envio de tags e renomeação de tags que já foram enviadas, caso a tag a renomear seja uma anotada , primeiro você poderá copiá-la graças à seguinte linha de comando de linha única:

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

Então, você só precisa excluir a tag antiga:

git tag -d old_tag

Encontrei esta linha de comando graças às duas respostas a seguir:

• https://stackoverflow.com/a/26132640/7009806 (segundo comentário)
• https://stackoverflow.com/a/49286861/7009806

Edit:
Depois de ter encontrado problemas com sincronização automática de etiquetas de configuração fetch.pruneTags=true(como descrito na https://stackoverflow.com/a/49215190/7009806 ), eu, pessoalmente, sugiro que primeiro copie o novo tag no servidor e , em seguida, apagar o antigo. Dessa forma, a nova tag não é excluída aleatoriamente ao excluir a tag antiga e a sincronização das tags gostaria de excluir a nova tag que ainda não está no servidor . Então, por exemplo, todos juntos temos:

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

Você também pode renomear tags remotas sem retirá-las, duplicando a tag / ramificação antiga para um novo nome e excluindo o antigo, em um único git push comando.

Tag de mudança de nome remoto / ramo remoto → conversão tag: (Aviso: :refs/tags/)

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

Renomeação ramo remoto / tag remoto → conversão ramo: (Aviso: :refs/heads/)

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

Saída renomeando uma tag remota:

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