Comandos de Git

git tag

git tag: etiqueta un commit de Git.

El comando git tag se usa para crear etiquetas en tu repositorio Git. Las etiquetas son como marcas o hitos que puedes usar para señalar puntos importantes del historial del proyecto, como versiones publicadas (v1.0.0, v2.0.0). Se parecen a las ramas, pero no se pueden mover una vez creadas: son puntos fijos.

Crear etiquetas no cambia el repositorio en sí (los commits etiquetados siguen siendo idénticos). En cambio, aporta más contexto e hitos dentro del desarrollo del proyecto, lo que facilita a equipos y colaboradores seguir el progreso, volver a versiones estables y entender el historial de cambios. También son útiles para automatizar compilaciones o la publicación de versiones, porque las herramientas pueden usar etiquetas para identificar qué versión publicada 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

Enviar todas las etiquetas a un repositorio remoto:

git push origin --tags

Enviar una etiqueta concreta a un repositorio remoto:

git push origin v1.0.0