¿Cómo etiquetar un commit en Git?

Etiquetar un commit en Git es una forma útil de marcar puntos específicos en la historia de tu proyecto como importantes. Las etiquetas se utilizan a menudo para marcar versiones de lanzamiento (por ejemplo, v1.0, v2.0) u otros hitos significativos. En este artículo, exploraremos cómo crear y gestionar etiquetas en Git.

¿Qué son las etiquetas en Git?

Las etiquetas en Git son referencias que apuntan a commits específicos. A diferencia de las ramas, que se mueven con nuevos commits, las etiquetas son estáticas y no cambian. Las etiquetas se utilizan típicamente para capturar una instantánea del repositorio en un punto particular en el tiempo, como un lanzamiento.

Tipos de etiquetas en Git

Existen dos tipos de etiquetas en Git:

• Etiquetas ligeras: Son simplemente referencias a un commit específico. Son esencialmente punteros con nombre a un commit.
• Etiquetas anotadas: Estas se almacenan como objetos completos en la base de datos de Git, conteniendo información adicional como el nombre del etiquetador, correo electrónico, fecha y un mensaje de etiquetado. Las etiquetas anotadas son recomendadas para la mayoría de los propósitos porque proporcionan más información.

Cómo crear una etiqueta ligera

Para crear una etiqueta ligera, usa el siguiente comando:

git tag <nombre-de-la-etiqueta>

Este comando crea una etiqueta con el nombre especificado que apunta al commit actual.

Ejemplo:

git tag v1.0

Esto crea una etiqueta ligera llamada v1.0 que apunta al commit actual.

Cómo crear una etiqueta anotada

Para crear una etiqueta anotada, usa la opción -a seguida del nombre de la etiqueta, y proporciona un mensaje usando la opción -m:

git tag -a <nombre-de-la-etiqueta> -m "Mensaje de la etiqueta"

Este comando crea una etiqueta anotada con el mensaje especificado.

Ejemplo:

git tag -a v1.0 -m "Versión de lanzamiento 1.0"

Esto crea una etiqueta anotada llamada v1.0 con el mensaje “Versión de lanzamiento 1.0”.

Cómo ver las etiquetas

Puedes ver todas las etiquetas en tu repositorio con el siguiente comando:

git tag

Esto lista todas las etiquetas en orden alfabético. Para ver los detalles de una etiqueta anotada, usa:

git show <nombre-de-la-etiqueta>

Este comando muestra el commit al que apunta la etiqueta, junto con el mensaje de la etiqueta y otros detalles.

Cómo empujar etiquetas a un repositorio remoto

Por defecto, las etiquetas no se empujan a un repositorio remoto cuando empujas commits. Para empujar una etiqueta específica, usa:

git push origin <nombre-de-la-etiqueta>

Para empujar todas las etiquetas a la vez, usa:

git push origin --tags

Cómo eliminar una etiqueta

Si necesitas eliminar una etiqueta, puedes hacerlo localmente y de forma remota:

Eliminar una etiqueta localmente

git tag -d <nombre-de-la-etiqueta>

Eliminar una etiqueta de un repositorio remoto

git push origin --delete <nombre-de-la-etiqueta>

Conclusión

Etiquetar commits en Git es una manera efectiva de marcar puntos importantes en la historia de tu proyecto. Ya sea que estés marcando un lanzamiento o un hito significativo, las etiquetas proporcionan una forma clara y consistente de navegar por la línea de desarrollo de tu proyecto.