A címkézés lehetővé teszi a fejlesztők számára, hogy projektjeik kidolgozása során fontos ellenőrző pontokat jelöljenek meg. Például a szoftverkiadási verziók címkézhetők. (Pl: v1.3.2) Lényegében lehetővé teszi, hogy egy elkötelezettnek külön nevet (címkét) adjon.
Az összes létrehozott címke betűrendben történő megtekintéséhez:
git tagTovábbi információ a címkéről:
git show v1.4Kétféle címke létezik:
Jegyzetelt
git tag -a v1.2 -m "my version 1.4"Könnyűsúlyú
git tag v1.2A tárolásuk módja különbözik egymástól.
Ezek címkéket hoznak létre a jelenlegi elkötelezettségén.
Inase, egy korábbi elkötelezettséget szeretne megcímkézni, adja meg a megcímkézni kívánt elkötelezettség azonosítóját:
git tag -a v1.2 9fceb02A címkék nevei felhasználhatók az elkötelezettség-azonosítók helyett, miközben távoli repóhoz való elkötelezettség ellenőrzése és nyomása történik.
Több információ:
- Git dokumentáció: Dokumentáció
- Git címkézés fejezet: Könyv
A projekt összes elérhető címkéjét felsorolhatja a git tagparanccsal (ne vegye figyelembe, hogy betűrendben jelennek meg):
$ git tag v1.0 v2.0 v3.0A címkék felsorolásának ez a módja nagyszerű kis projekteknél, de a nagyobb projektek több száz címkével rendelkezhetnek, ezért előfordulhat, hogy szűrni kell őket, amikor a történelem egyik fontos pontjára keresünk. Megtalálható címkéket tartalmazó speciális karakterek hozzáadásával -la git tagparancsot:
$ git tag -l "v2.0*" v2.0.1 v2.0.2 v2.0.3 v2.0.4Hozzon létre egy címkét
Kétféle címkét hozhat létre: kommentált és könnyű. Elsők versenyobjektumok a GIT adatbázisban: ellenőrző összegek vannak, üzenetet igényelnek (például a vállalásokat), és más fontos adatokat tárolnak, mint például név, e-mail és dátum. Másrészt a könnyű címkék nem igényelnek üzenetet, vagy más adatokat tárolnak, amelyek csak a projekt egy adott pontjának mutatójaként működnek.
Hozzon létre kommentált címkét
Anotált címke létrehozásához adja hozzá -a tagname -m "tag message"a git tagparancshoz:
$ git tag -a v4.0 -m "release version 4.0" $ git tag v1.0 v2.0 v3.0 v4.0Amint láthatja, -amegadja, hogy kommentált címkét hoz létre, utána jön a címke neve, végül -mpedig a címkeüzenet, amelyet a Git adatbázisban kell tárolni.
Hozzon létre egy könnyű címkét
A könnyű címkék csak a végrehajtás ellenőrző összegét tartalmazzák (más információt nem tárolnak). Egy ilyen létrehozásához egyszerűen futtassa a git tagparancsot minden egyéb lehetőség nélkül (a név végén található -lw karaktereket a könnyű címkék jelzésére használják, de tetszés szerint megjelölheti őket):
$ git tag v4.1-lw $ git tag v1.0 v2.0 v3.0 v4.0 v4.1-lwEzúttal nem adott meg üzenetet vagy egyéb releváns adatot, ezért a címke csak a hivatkozott elkötelezettség ellenőrző összegét tartalmazza.
A címke adatainak megtekintése
A git showparanccsal futtathatja a címkében tárolt adatokat. Megjegyzésekkel ellátott címkék esetén a címke és a véglegesítés adatai láthatók:
$ git show v4.0 tag v4.0 Tagger: John Cash Date: Mon Sat 28 15:00:25 2017 -0700 release version 4.0 commit da43a5fss745av88d47839247990022a98419093 Author: John Cash Date: Fri Feb 20 20:30:05 2015 -0700 finished detailsHa a nézett címke könnyű címke, akkor csak a hivatkozott elkötelezettségi adatokat látja:
$ git show v1.4-lw commit da43a5f7389adcb9201ab0a289c389ed022a910b Author: John Cash Date: Fri Feb 20 20:30:05 2015 -0700 finished detailsA régi vállalások címkézése
Megcímkézheti a múltbeli elkötelezettségeket a git tag-elkötelezettséggel is. Ehhez meg kell adnia a végrehajtás ellenőrző összegét (vagy legalább egy részét) a parancssorban.
Először futtassa a git naplót, hogy megtudja a szükséges kötelezettség ellenőrző összegét:
$ git log --pretty=oneline ac2998acf289102dba00823821bee04276aad9ca added products section d09034bdea0097726fd8383c0393faa0072829a7 refactorization a029ac120245ab012bed1ca771349eb9cca01c0b modified styles da43a5f7389adcb9201ab0a289c389ed022a910b finished details 0adb03ca013901c1e02174924486a08cea9293a2 small fix in search textarea stylesHa megvan a szükséges ellenőrző összeg, adja hozzá a címke létrehozási sorának végén:
$ git tag -a v3.5 a029acLátni fogja, hogy a címke helyesen lett hozzáadva git tag:
$ git tag v1.0 v2.0 v3.0 v3.5 v4.0 v4.1-lwNyomja meg a címkéket
A Git alapértelmezés szerint nem nyomja meg a címkéket, amikor a git push parancsot futtatja. Tehát a címke sikeres kiszolgálásához meg kell git push originparancsolnia:
$ git push origin v4.0 Counting objects: 14, done. Delta compression using up to 8 threads. Compressing objects: 100% (16/16), done. Writing objects: 100% (18/18), 3.15 KiB | 0 bytes/s, done. Total 18 (delta 4), reused 0 (delta 0) To [email protected]:jcash/gitmanual.git * [new tag] v4.0 -> v4.0You can also use the --tags option to add multiple tags at once with the git push origin command:
$ git push origin --tags Counting objects: 1, done. Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done. Total 1 (delta 0), reused 0 (delta 0) To [email protected]:jcash/gitmanual.git * [new tag] v4.0 -> v4.0 * [new tag] v4.1-lw -> v4.1-lwChecking out Tags
You can use git checkout to checkout to a tag like you would normally do. But you need to keep in mind that this would result a detached HEAD state.
$ git checkout v0.0.3 Note: checking out 'v0.0.3'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout.Deleting a Tag
You may find a situation were you want to delete a certain tag. There’s a very useful command for this situations:
$ git tag --delete v0.0.2 $ git tag v0.0.1 v0.0.3 v0.0.4More Information
- Git Pro - Tagging Basics
- Git Pro - Documentation
- Git HowTo
- Git tip: Tags
- Creating a tag
Sources
Git documentation: tags