Etiquetado de versiones con git tag
En este post vamos a explorar el concepto de etiquetado de GIT con su comando git tag
En este post vamos a explorar el concepto de etiquetado de GIT con su comando git tag. El etiquetado se usa generalmente para capturar un punto del historial que se utiliza para una versión marcada.
Una etiqueta es como una rama que no cambia. A diferencia de las ramas, las etiquetas, una vez creadas, no tienen historial de confirmaciones.
📑 Documentación oficial
- https://git-scm.com/book/en/v2/Git-Basics-Tagging
- https://git-scm.com/book/es/v2/Fundamentos-de-Git-Etiquetado
- https://www.atlassian.com/git/tutorials/inspecting-a-repository/git-tag
🏷️ ¿Qué es git tag?
git tag sirve para poner una etiqueta en un commit específico, generalmente para marcar una versión (por ejemplo, v1.0.0).
🔹 No cambia el código.
🔹 Solo marca un punto importante en la historia: como una versión estable, un lanzamiento, una beta, etc.
🧠 ¿Para qué se usa?
- Para publicar releases (como
v1.0.0,v2.1.3, etc.). - Para identificar commits importantes.
- Para volver fácilmente a un punto estable.
🧪 Ejemplo práctico de uso de git tag
1️⃣ Crea una carpeta y un repositorio nuevo
mkdir mi-proyecto-tag
cd mi-proyecto-tag
git init
2️⃣ Crea un archivo inicial
echo "# Mi proyecto" > README.md
git add README.md
git commit -m "feat: primera versión del proyecto"
3️⃣ Crea tu primer tag
git tag v1.0.0
4️⃣ Verifica que el tag fue creado
git tag
5️⃣ Agrega más cambios
echo "Versión 2" >> README.md
git add README.md
git commit -m "feat: añadida sección de versión 2"
6️⃣ Crea un segundo tag anotado
git tag -a v2.0.0 -m "Segunda versión del proyecto"
Lista todos los tags con información:
git show v2.0.0
7️⃣ Muévete entre tags
git checkout v1.0.0
Observa que ahora tu proyecto está en el estado de la versión 1.0.0 (en modo detached HEAD).
Vuelve al estado normal:
git checkout main
8️⃣ Sube los tags a GitHub (opcional, si tienes remoto)
git remote add origin https://github.com/tuusuario/mi-proyecto-tag.git
git push origin main
git push origin --tags
9️⃣ Extra: Borrar un tag
Localmente:
git tag -d v1.0.0
En remoto:
git push origin --delete tag v1.0.0
🎯 Tipos de etiquetas
| Tipo | Descripción |
|---|---|
| Etiqueta ligera | Solo un nombre apuntando a un commit. |
| Etiqueta anotada | Guarda información extra (autor, fecha, mensaje). Recomendado para releases. |
Crear una etiqueta anotada:
git tag -a v1.0.0 -m "Primera versión oficial"
-a: indica que es anotada.-m: mensaje asociado.
🚀 Resumen express
| Comando | Función |
|---|---|
git tag |
Ver todas las etiquetas |
git tag <nombre> |
Crear una etiqueta ligera |
git tag -a <nombre> -m "<msg>" |
Crear una etiqueta anotada |
git push origin <nombre> |
Subir una etiqueta |
git push origin --tags |
Subir todas las etiquetas |
git tag -d <nombre> |
Borrar etiqueta local |
git push origin --delete tag <nombre> |
Borrar etiqueta remota |