Introducció

En aquest tema, aprendrem com utilitzar les etiquetes (tags) en Git. Les etiquetes són una manera d'assignar una referència llegible per a humans a un commit específic. Són molt útils per marcar versions de llançament (releases) o altres punts importants en la història del projecte.

Tipus d'Etiquetes

Hi ha dos tipus principals d'etiquetes en Git:

  1. Etiquetes Lleugeres (Lightweight Tags): Són essencialment un enllaç a un commit específic.
  2. Etiquetes Anotades (Annotated Tags): Són objectes Git complets que contenen informació addicional com el nom de l'autor, la data i un missatge.

Comparació d'Etiquetes Lleugeres i Anotades

Característica Etiqueta Lleugera (Lightweight) Etiqueta Anotada (Annotated)
Conté Metadades No
Conté Missatge No
Ús Recomanat Marcar commits temporals Marcar versions de llançament
Com Crear git tag <tagname> git tag -a <tagname> -m "message"

Creant Etiquetes

Etiqueta Lleugera

Per crear una etiqueta lleugera, simplement utilitza el següent comandament:

git tag v1.0

Això crearà una etiqueta anomenada v1.0 en el commit actual.

Etiqueta Anotada

Per crear una etiqueta anotada, utilitza el següent comandament:

git tag -a v1.0 -m "Versió 1.0"

Això crearà una etiqueta anotada anomenada v1.0 amb el missatge "Versió 1.0".

Llistant Etiquetes

Per veure totes les etiquetes en el teu repositori, utilitza:

git tag

Si vols veure més detalls sobre una etiqueta anotada específica, pots utilitzar:

git show v1.0

Empenyent Etiquetes a un Repositori Remot

Per empènyer una etiqueta específica a un repositori remot, utilitza:

git push origin v1.0

Per empènyer totes les etiquetes alhora, utilitza:

git push origin --tags

Eliminant Etiquetes

Localment

Per eliminar una etiqueta localment, utilitza:

git tag -d v1.0

Remotament

Per eliminar una etiqueta d'un repositori remot, primer elimina-la localment i després empènyer el canvi:

git push origin --delete v1.0

Exercicis Pràctics

Exercici 1: Creant una Etiqueta Lleugera

  1. Crea una etiqueta lleugera anomenada v1.1 en el commit actual.
  2. Llista totes les etiquetes per verificar que v1.1 ha estat creada.

Solució

git tag v1.1
git tag

Exercici 2: Creant una Etiqueta Anotada

  1. Crea una etiqueta anotada anomenada v2.0 amb el missatge "Versió 2.0".
  2. Mostra els detalls de l'etiqueta v2.0.

Solució

git tag -a v2.0 -m "Versió 2.0"
git show v2.0

Exercici 3: Empenyent una Etiqueta a un Repositori Remot

  1. Empeny l'etiqueta v2.0 al repositori remot.
  2. Verifica que l'etiqueta ha estat empesa correctament.

Solució

git push origin v2.0

Errors Comuns i Consells

  • Error: "tag already exists": Això passa quan intentes crear una etiqueta amb un nom que ja existeix. Assegura't d'utilitzar noms únics per a les teves etiquetes.
  • No oblidis empènyer les etiquetes: Les etiquetes no es pugen automàticament amb git push. Has d'utilitzar git push origin <tagname> o git push origin --tags.

Conclusió

Les etiquetes són una eina poderosa per marcar punts importants en la història del teu projecte. Ara que saps com crear, llistar, empènyer i eliminar etiquetes, pots utilitzar-les per gestionar millor les versions i els llançaments del teu projecte. En el següent tema, explorarem com revertir commits en Git.

Dominar Git: De Principiant a Avançat

Mòdul 1: Introducció a Git

Mòdul 2: Operacions Bàsiques de Git

Mòdul 3: Branques i Fusió

Mòdul 4: Treballant amb Repositoris Remots

Mòdul 5: Operacions Avançades de Git

Mòdul 6: Eines i Tècniques de Git

Mòdul 7: Estratègies de Col·laboració i Flux de Treball

Mòdul 8: Millors Pràctiques i Consells de Git

Mòdul 9: Resolució de Problemes i Depuració

Mòdul 10: Git en el Món Real

© Copyright 2024. Tots els drets reservats