En el siguiente artículo se describirá el uso del comando tag en Git y su uso para el manejo de repositorios.

Tags

Los tags o etiquetas permiten especificar puntos o commits específicos dentro de un repositorios que son considerados importantes. Su uso más común es el determinar los puntos en los que un proyecto se considera una nueva versión o release. Por esta razón el nombre de los tags suelen comenzar con la letra v seguido por el número de versión.

Crear tag

En el caso de querer generar un tag para el último commit realizado en la rama solamente es necesario definir el nombre que tendrá la etiqueta.

git tag <nombre>

También es posible asignarle una descripción utilizando -a para definir el nombre del tag y -m para su descripción.

git tag -a <nombre> -m "<descripcion>"

En el caso de querer asignar un tag a un commit anterior es necesario definir el commit al cual quiere etiquetarse utilizando el id de commit.

git tag -a <nombre> <commit>

Finalmente para subir la etiqueta creada al repositorio es necesario especificar la rama y el nombre de tag.

git push origin <nombre>

Listar tags

Es posible ver la lista de tags de un proyecto utilizando el comando:

git tag

V1.0
V1.1

Al agregar -l es posible listar solo las etiquetas cuyos nombres concuerden con un patrón dado. En el siguiente caso se listan las etiquetas cuyo nombre comience con V0.

git tag -l "V0.*"

Ver información de un tag

Para ver información de una etiqueta se utiliza el comando show seguido de el nombre de la etiqueta. Esto muestra los datos propios del tag como su nombre, descripción, fecha y autor. También muestra los datos correspondientes al commit asociado.

git show <nombre>

git show V1.0

tag V1.0
Tagger: Andrea Navarro <andrea@juncotic.com>
Date:   Thu Jun 25 16:41:21 2020 -0300

Mensaje del tag

commit 52gue5cdee11f24a8dc5300a2ad918a4e3f9a0fe (tag: V1.0)
Author: Andrea Navarro <andrea@juncotic.com>
Date:   Thu Jun 25 16:36:25 2020 -0300

Mensaje del commit

Eliminar tag

Para eliminar una etiqueta que no ha sido publicada se utiliza -d seguido por el nombre de la etiqueta a eliminar.

git tag -d <nombre>

Si se quiere eliminar una etiqueta que ya ha sido publicada entonces se debe realizar a través de un push donde se defina la rama y nombre de la etiqueta a eliminar.

 git push origin --delete <nombre>

Ver estado del proyecto para un tag

Para obtener el estado de un proyecto en una etiqueta en particular se utiliza el comando checkout seguido por el nombre de la etiqueta.

git checkout <nombre>

Esto llevará al proyecto al estado en el que se encontraba en el commit correspondiente a dicho tag incluyendo archivos y las modificaciones realizadas.

Al finalizar con el checkout es necesario volver al estado actual del proyecto. Para esto se vuelve a realizar un checkout.

git checkout master

Espero que les sirva!