¿Cómo Crear una Etiqueta en Git?

Las etiquetas en Git se utilizan para marcar puntos específicos en la historia de tu repositorio como importantes. Esto se hace a menudo para denotar versiones en un proyecto, como marcar un commit que representa un lanzamiento. Las etiquetas de Git son referencias inmutables a los commits y son una parte vital del control de versiones en muchos proyectos. Este artículo te guiará a través de los pasos para crear una etiqueta en Git y explicará las diferencias entre etiquetas ligeras y etiquetas anotadas.

Tipos de Etiquetas en Git

Git admite dos tipos de etiquetas:

• Etiquetas Ligeras: Son simples referencias a un commit. Son como una rama que no cambia, pero sin ningún metadato.
• Etiquetas Anotadas: Son objetos completos en la base de datos de Git. Almacenan metadatos como el nombre del etiquetador, correo electrónico, fecha y un mensaje. Las etiquetas anotadas son recomendadas para marcar puntos importantes en la historia de tu proyecto.

Cómo Crear una Etiqueta Ligera

Para crear una etiqueta ligera, simplemente ejecuta:

git tag <nombre-de-etiqueta>

Sustituye <nombre-de-etiqueta> con el nombre de etiqueta deseado.

Ejemplo:

git tag v1.0

Este comando crea una etiqueta ligera llamada v1.0 en el commit actual.

Cómo Crear una Etiqueta Anotada

Se recomiendan las etiquetas anotadas porque almacenan más información. Para crear una etiqueta anotada, usa la opción -a:

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

Sustituye <nombre-de-etiqueta> con el nombre de etiqueta deseado y "Mensaje de la etiqueta" con un mensaje significativo.

Ejemplo:

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

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

Cómo Ver Etiquetas

Para ver las etiquetas en tu repositorio, usa:

git tag

Este comando lista todas las etiquetas en tu repositorio. Si quieres ver más detalles sobre una etiqueta específica, usa:

git show <nombre-de-etiqueta>

Sustituye <nombre-de-etiqueta> con el nombre de la etiqueta que deseas inspeccionar.

Cómo Empujar Etiquetas a un Repositorio Remoto

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

git push origin <nombre-de-etiqueta>

Para empujar todas las etiquetas, usa:

git push origin --tags

Cómo Eliminar una Etiqueta

Si necesitas eliminar una etiqueta, puedes hacerlo localmente con:

git tag -d <nombre-de-etiqueta>

Para eliminar una etiqueta de un repositorio remoto, debes empujar una solicitud de eliminación:

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

Mejores Prácticas para Usar Etiquetas

• Usa Etiquetas Anotadas para Lanzamientos: Las etiquetas anotadas almacenan información importante y son ideales para marcar puntos de lanzamiento en tu proyecto.
• Mantén Nombres de Etiquetas Consistentes: Establece una convención de nomenclatura para tus etiquetas (por ejemplo, v1.0, v2.0) y mantente fiel a ella para la consistencia.
• Documenta las Prácticas de Etiquetado: Documenta claramente tus prácticas de etiquetado en los archivos README o CONTRIBUTING de tu proyecto para asegurar consistencia en todo tu equipo.

Conclusión

Crear etiquetas en Git es una manera simple pero poderosa de marcar hitos importantes en tu proyecto. Ya sea que uses etiquetas ligeras o anotadas, te ayudan a gestionar y organizar la historia de tu proyecto, facilitando el seguimiento de versiones y lanzamientos.