Comandos de Git

git tag

git tag: etiqueta un commit de Git.

El comando git tag crea etiquetas en el repositorio. Son marcas o hitos que señalan puntos importantes del historial, como versiones publicadas (v1.0.0, v2.0.0). Se parecen a las ramas, pero no se mueven una vez creadas: son puntos fijos.

Crear una etiqueta no modifica el commit al que apunta: su contenido sigue siendo idéntico. La etiqueta aporta contexto al desarrollo del proyecto y facilita seguir el progreso, volver a versiones estables y entender el historial. También resulta útil para automatizar compilaciones o publicaciones, porque las herramientas pueden usarla para identificar qué versión publicada deben empaquetar o desplegar.

En Git hay dos tipos de etiquetas:

  • Etiquetas ligeras: son simples punteros a commits concretos. Se usan sobre todo para referenciar commits con nombres legibles por personas.

  • Etiquetas anotadas: se guardan como objetos completos en la base de datos de Git, con el nombre de quien crea la etiqueta, su correo, la fecha y un mensaje de etiqueta. Se pueden firmar con GPG y verificar para aportar seguridad y confianza. Estas etiquetas se recomiendan para marcar versiones oficiales porque contienen información adicional.

Ejemplos

Crear una etiqueta anotada llamada v1.0.0:

git tag -a v1.0.0 -m "Release version 1.0.0"

Crear una etiqueta ligera llamada v1.0.1:

git tag v1.0.1

Listar todas las etiquetas:

git tag

Eliminar una etiqueta llamada v1.0.1:

git tag -d v1.0.1

Hacer push de todas las etiquetas a un repositorio remoto:

git push origin --tags

Hacer push de una etiqueta concreta a un repositorio remoto:

git push origin v1.0.0