git tag
git
Uso
git tag [-a] <name> [<commit>]Pone un nombre, como una versión, en un commit; un git push normal no lleva las etiquetas, hay que empujar la etiqueta por su nombre.
Opciones habituales
| Opción | Significado |
|---|---|
| -a | annotated tag with a message, author and date |
| -m "<msg>" | the message for -a |
| -l "<pattern>" | list tags matching a pattern |
| -d <name> | delete a tag locally |
| -f | move an existing tag |
| --sort=-creatordate | newest tag first |
Ejemplos
git tag -a v1.2.0 -m "release 1.2.0"marks the current commit as a release
git push origin v1.2.0the separate step that puts the tag on the server
git tag -d v1.2.0deletes it locally; the server keeps its copy
Lo confuso es que deshacer tiene varias formas: mover a dónde apunta una rama no es lo mismo que añadir un commit que la revierte.
Cómo leerlo
- Los corchetes [ ] marcan una parte que puedes omitir.
- Los puntos suspensivos … indican que puedes poner varios.
- Las opciones distinguen mayúsculas: en algunos comandos -r y -R no hacen lo mismo.
Preguntas
Q. ¿Qué hace git tag?
Pone un nombre, como una versión, en un commit; un git push normal no lleva las etiquetas, hay que empujar la etiqueta por su nombre.
Q. ¿Cómo se escribe?
git tag [-a] <name> [<commit>] — los corchetes marcan lo que puedes omitir.
Q. ¿Cuántas opciones vale la pena saber?
Aquí van 6; la lista completa está en man git. Este comando está en git.
Comandos relacionados
página man: man git-tag