Marcar versiones

Un hash como 54da6e2 identifica un momento perfectamente, pero no se puede decir por teléfono. Las etiquetas son eso: ponerle a un commit un nombre que un humano pueda repetir 🏷️

Qué numero poner

La costumbre más extendida son tres números, 1.4.2, y cada uno dice algo:

No hay policía de versiones: si tu proyecto es tuyo, numera como quieras. Pero si otra gente lo usa, esta convención les dice de un vistazo si actualizar es seguro 🚦

Poner la primera

mkdir reporte-ventas
cd reporte-ventas
git init -q
printf 'ciudad,monto\nLima,1200\nArequipa,890\n' > ventas.csv
git add ventas.csv
git commit -q -m "Primeras ventas de Lima y Arequipa"
git tag -a v1.0 -m "Primera version del reporte por ciudad"
git tag
git log --oneline --decorate -1

v1.0
2a3fc36 (HEAD -> main, tag: v1.0) Primeras ventas de Lima y Arequipa

Ese -a hace la etiqueta anotada, que guarda quién la puso, cuándo y por qué. Sin él sale una etiqueta ligera, que es solo un apodo. Para versiones que se publican, siempre anotada 📌

git show v1.0 --stat

tag v1.0
Tagger: Miss Yera <hola@missyera.com>
Date:   Thu Jan 15 09:00:00 2026 -0500

Primera version del reporte por ciudad

commit 2a3fc36beb5c2a9e53847d7ea23f4af29abc0159
Author: Miss Yera <hola@missyera.com>
Date:   Thu Jan 15 09:00:00 2026 -0500

    Primeras ventas de Lima y Arequipa

 ventas.csv | 3 +++
 1 file changed, 3 insertions(+)

Seguir trabajando y marcar otra

printf 'canal,monto\nBodegas,4200\n' > canales.csv
git add canales.csv
git commit -q -m "Se agrega el corte por canal"
git tag -a v1.1 -m "Entra el corte por canal"
printf 'Horeca,3100\n' >> canales.csv
git add canales.csv
git commit -q -m "Entra el canal horeca"
git tag
git log --oneline --decorate

v1.0
v1.1
98967f2 (HEAD -> main) Entra el canal horeca
f1d698c (tag: v1.1) Se agrega el corte por canal
2a3fc36 (tag: v1.0) Primeras ventas de Lima y Arequipa

Las etiquetas se quedan pegadas a su commit aunque la historia siga creciendo. Por eso sirven 📍

Dónde estoy respecto a la última versión

git describe --tags

v1.1-1-g98967f2

Léelo así: estás en la v1.1, más un commit, y el hash del que estás. Es lo que se pone en un pie de página o en un --version para saber exactamente qué está corriendo 🧭

Volver a una versión para mirarla

git switch -q --detach v1.0
ls
cat ventas.csv
git switch -q -
ls

ventas.csv
ciudad,monto
Lima,1200
Arequipa,890
canales.csv
ventas.csv

En v1.0 todavía no existía canales.csv. Miraste el pasado y volviste, sin tocar nada 🕰️

Subirlas, que es el paso que se olvida

git push a secas no lleva las etiquetas. Hay que pedirlo:

cd ..
git init -q --bare servidor.git
cd reporte-ventas
git remote add origin ../servidor.git
git push -q -u origin main
git ls-remote --tags origin
echo "(vacio: el push no se llevo las etiquetas)"
git push -q origin --tags
git ls-remote --tags origin

(vacio: el push no se llevo las etiquetas)
338723d51e19edad2924403c1b845d25495ef487	refs/tags/v1.0
2a3fc36beb5c2a9e53847d7ea23f4af29abc0159	refs/tags/v1.0^{}
7612cccf58b10b4b71b6fcf891980fc26dca89aa	refs/tags/v1.1
f1d698c97156556250655f4ab4f20d30c03c1d10	refs/tags/v1.1^{}

Ahí están. Es el olvido más común del capítulo: la versión marcada en tu máquina y nadie más la ve 🙈

Qué es un release entonces

Un release es de GitHub, no de Git: es una etiqueta más una página con notas de la versión y archivos para descargar. Se crea desde Releases > Draft a new release eligiendo una etiqueta que ya exista.

O sea que el orden es: etiqueta primero, release después. Y lo que hace valioso a un release son las notas: qué cambió, qué se rompe y qué hay que hacer para actualizar 📝

$ git tag -f v1.0
Updated tag 'v1.0' (was 3c1f80a)
$ git push -f origin v1.0

# y en la maquina de tu compañera, que ya la tenia:
$ git describe --tags
v1.0        # pero apuntando a otro commit

Comprueba que se entendió

Ejercicios

cd ..
mkdir catalogo
cd catalogo
git init -q
printf 'bodega,ciudad\nBodega Inti,Cusco\n' > bodegas.csv
git add bodegas.csv
git commit -q -m "Catalogo inicial de bodegas"
git tag -a v1.0 -m "Primera version del catalogo"
git tag
git log --oneline --decorate -1

v1.0
a9874ae (HEAD -> main, tag: v1.0) Catalogo inicial de bodegas

git show v1.0 --stat

tag v1.0
Tagger: Miss Yera <hola@missyera.com>
Date:   Thu Jan 15 09:00:00 2026 -0500

Primera version del catalogo

commit a9874ae5ade9ebff480ec9f29629b1b651573849
Author: Miss Yera <hola@missyera.com>
Date:   Thu Jan 15 09:00:00 2026 -0500

    Catalogo inicial de bodegas

 bodegas.csv | 2 ++
 1 file changed, 2 insertions(+)

printf 'Minimarket Sol,Trujillo\n' >> bodegas.csv
git add bodegas.csv
git commit -q -m "Entra el minimarket de Trujillo"
git tag -a v1.1 -m "Entran los minimarkets"
git tag
git log --oneline --decorate

v1.0
v1.1
4cb519a (HEAD -> main, tag: v1.1) Entra el minimarket de Trujillo
a9874ae (tag: v1.0) Catalogo inicial de bodegas

printf 'Mayorista Norte,Piura\n' >> bodegas.csv
git add bodegas.csv
git commit -q -m "Entra el mayorista de Piura"
git describe --tags

v1.1-1-gb9f725d

git switch -q --detach v1.0
cat bodegas.csv
git switch -q -
cat bodegas.csv

bodega,ciudad
Bodega Inti,Cusco
bodega,ciudad
Bodega Inti,Cusco
Minimarket Sol,Trujillo
Mayorista Norte,Piura

cd ..
git init -q --bare catalogo-servidor.git
cd catalogo
git remote add origin ../catalogo-servidor.git
git push -q -u origin main
git ls-remote --tags origin
echo "(vacio)"
git push -q origin --tags
git ls-remote --tags origin

(vacio)
419ab5b7a0a3013255e90441edc5eaa0cff0c009	refs/tags/v1.0
a9874ae5ade9ebff480ec9f29629b1b651573849	refs/tags/v1.0^{}
5a7e66660e45be3d87f34c46a36b17047428c670	refs/tags/v1.1
4cb519af668b35459949b56f5823d8dc0c4b868a	refs/tags/v1.1^{}

git tag -a v1.0 -m "Otra vez la primera"

fatal: tag 'v1.0' already exists

Lo que te llevas

Una etiqueta anotada por versión, se sube con --tags, y una vez publicada no se mueve.