¿Cómo se cambia el nombre de una etiqueta Git?

Hoy estaba buscando un proyecto a través de los registros y me di cuenta de que hacía mucho que buscaba un nombre de etiqueta. ¿Hay alguna forma de cambiar el nombre de la etiqueta? Google no ha encontrado nada útil.

Me di cuenta de que podía ver la versión etiquetada y hacer una nueva etiqueta, incluso lo intenté. Pero eso parece crear un objeto de etiqueta que no es del todo correcto. Para uno,

git tag -l

lo enumera fuera de servicio en relación con todas las otras etiquetas. No tengo idea de si eso es significativo, pero me lleva a creer que el nuevo objeto de etiqueta no es exactamente lo que quiero. Puedo vivir con eso, porque realmente solo me importa que el nombre de la etiqueta coincida con la documentación, pero prefiero hacerlo "bien", suponiendo que haya una manera correcta de hacerlo.

Así es como cambio el nombre de una etiqueta olda new:

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

Los dos puntos en el comando push eliminan la etiqueta del repositorio remoto. Si no hace esto, Git creará la etiqueta anterior en su máquina cuando tire.

Finalmente, asegúrese de que los otros usuarios eliminen la etiqueta eliminada. Dígales a ellos (compañeros de trabajo) que ejecuten el siguiente comando:

git pull --prune --tags

Tenga en cuenta que si está cambiando una etiqueta anotada , debe asegurarse de que el nuevo nombre de la etiqueta haga referencia a la confirmación subyacente y no al antiguo objeto de la etiqueta anotada que está a punto de eliminar. Por lo tanto, use en git tag -a new old^{}lugar de git tag new old(esto se debe a que las etiquetas anotadas son objetos mientras que las etiquetas livianas no lo son, más información en esta respuesta ).

La pregunta original era cómo cambiar el nombre de una etiqueta, que es fácil: primero crear nuevas como un alias de VIEJO: git tag NEW OLDa continuación, eliminar VIEJO: git tag -d OLD.

La cita sobre "la forma Git" y la (in) cordura está fuera de lugar, porque se trata de preservar un nombre de etiqueta, pero hacer que se refiera a un estado de repositorio diferente.

Además de las otras respuestas:

Lo primero que necesita para construir un alias del antiguo nombre de la etiqueta, que apunta a la original cometer:

git tag new old^{}

Luego debe eliminar el antiguo localmente :

git tag -d old

Luego, elimine la etiqueta en su (s) ubicación (es) remota (s):

# 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, debe agregar su nueva etiqueta a la ubicación remota. Hasta que haya hecho esto, no se agregarán las nuevas etiquetas :

git push origin --tags

Itere esto para cada ubicación remota.

¡Tenga en cuenta las implicaciones que un cambio de etiqueta Git tiene para los consumidores de un paquete!

Si se publica, no puede eliminarlo (sin arriesgarse a ser asfaltado y con plumas). La 'forma Git' es hacer:

Lo cuerdo. Solo admite que te equivocaste y usa un nombre diferente. Otros ya han visto un nombre de etiqueta, y si mantiene el mismo nombre, es posible que dos personas tengan "versión X", pero en realidad tienen "X" diferentes. Así que simplemente llámalo "X.1" y termina de una vez.

Alternativamente,

Lo loco. Realmente quieres llamar a la nueva versión "X" también, aunque otros ya hayan visto la anterior. Así que solo usa git-tag -f nuevamente, como si aún no hubieras publicado el anterior.

Es una locura porque:

Git no (y no debería) cambiar las etiquetas detrás de los usuarios. Entonces, si alguien ya tiene la etiqueta anterior, hacer un git-pull en su árbol no debería hacer que sobrescriba la anterior.

Si alguien recibió una etiqueta de lanzamiento de usted, no puede simplemente cambiar la etiqueta para ellos actualizando la suya. Este es un gran problema de seguridad, ya que las personas DEBEN poder confiar en sus nombres de etiquetas. Si realmente quieres hacer lo loco, solo tienes que confesar y decirle a la gente que te equivocaste.

Toda cortesía de las páginas del manual .

Esta página wiki tiene esta interesante frase, que nos recuerda que podemos empujar varias referencias :

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

y pedirle a otros cloners que hagan git pull --prune --tags

Entonces la idea es impulsar:

• <new-tag>por cada commit que hace referencia <old-tag>: <refs/tags/old-tag>:<refs/tags/new-tag>,
• la eliminación de<old-tag> ::<refs/tags/old-tag>

Vea como ejemplo "¿ Cambiar la convención de nomenclatura de etiquetas dentro de un repositorio git? ".

Como complemento de las otras respuestas, agregué un alias para hacerlo todo en un solo paso, con una sensación de comando de movimiento * nix más familiar. El argumento 1 es el nombre de la etiqueta anterior, el argumento 2 es el nombre de la etiqueta nueva.

[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 el enfoque de 3 pasos para una o varias etiquetas.

Paso 1: Identifique el ID de compromiso / objeto del compromiso al que apunta la etiqueta actual

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

Paso 2: elimine la etiqueta del repositorio

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

Paso 3: cree una nueva etiqueta que apunte a la misma identificación de confirmación a la que apuntaba la etiqueta anterior

     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 vez que el git local está listo con el cambio de nombre de la etiqueta, estos cambios se pueden volver al origen para que otros los tomen.

Para los aventureros se puede hacer en un solo comando:

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

Independientemente de los problemas relacionados con las etiquetas de inserción y el cambio de nombre de las etiquetas que ya se han enviado, en caso de que la etiqueta para cambiar el nombre sea anotada , primero puede copiarla gracias a la siguiente línea de comando de una sola línea:

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

Luego, solo necesita eliminar la etiqueta anterior:

git tag -d old_tag

Encontré esta línea de comando gracias a las siguientes dos respuestas:

• https://stackoverflow.com/a/26132640/7009806 (segundo comentario)
• https://stackoverflow.com/a/49286861/7009806

Editar:
Habiendo encontrado problemas al usar la configuración de sincronización automática de etiquetas fetch.pruneTags=true(como se describe en https://stackoverflow.com/a/49215190/7009806 ), personalmente sugiero que primero copie la nueva etiqueta en el servidor y luego elimine la anterior. De esa manera, la nueva etiqueta no se elimina aleatoriamente cuando se elimina la etiqueta anterior y una sincronización de las etiquetas le gustaría eliminar la nueva etiqueta que aún no está en el servidor . Entonces, por ejemplo, todos juntos obtenemos:

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

También puede cambiar el nombre de las etiquetas remotas sin retirarlas, duplicando la etiqueta / rama anterior con un nuevo nombre y eliminando la anterior, en un solo git pushcomando.

Cambiar nombre etiqueta remoto / rama remoto → conversión de la etiqueta: (Nota: :refs/tags/)

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

Cambiar nombre rama remoto / tag remoto → conversión rama: (Nota: :refs/heads/)

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

Salida renombrando una etiqueta 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