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 tag
További információ a címkéről:
git show v1.4
Kétféle címke létezik:
Jegyzetelt
git tag -a v1.2 -m "my version 1.4"
Könnyűsúlyú
git tag v1.2
A 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 9fceb02
A 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 tag
paranccsal (ne vegye figyelembe, hogy betűrendben jelennek meg):
$ git tag v1.0 v2.0 v3.0
A 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 -l
a git tag
parancsot:
$ git tag -l "v2.0*" v2.0.1 v2.0.2 v2.0.3 v2.0.4
Hozzon 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 tag
parancshoz:
$ git tag -a v4.0 -m "release version 4.0" $ git tag v1.0 v2.0 v3.0 v4.0
Amint láthatja, -a
megadja, hogy kommentált címkét hoz létre, utána jön a címke neve, végül -m
pedig 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 tag
parancsot 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-lw
Ezú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 show
paranccsal 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 details
Ha 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 details
A 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 styles
Ha 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 a029ac
Lá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-lw
Nyomja 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 origin
parancsolnia:
$ 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.0
You 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-lw
Checking 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.4
More Information
- Git Pro - Tagging Basics
- Git Pro - Documentation
- Git HowTo
- Git tip: Tags
- Creating a tag
Sources
Git documentation: tags