2.6 Git Basics - Etiketleme

Git’te mevcut etiketleri listelemek çok basittir. Sadece git tag (isterseniz -l veya --list seçenekleriyle) yazmanız yeterlidir:

Bu komut, etiketleri alfabetik sıraya göre listeler ama görüntülenme sırasının aslında bir önemi yoktur.

Ayrıca belli kalıplarla eşleşen etiketleri de arayabilirsiniz. Örneğin Git kaynak reposu 500’den fazla etiket içerir. Eğer sadece 1.8.5 serisine bakmak istiyorsanız şunu çalıştırabilirsiniz:

Git, iki çeşit etiketi destekler: lightweight (hafif) ve annotated (açıklamalı).

Hafif bir etiket, değişmeyen bir Git dalı gibidir; yalnızca belirli bir katkının işaretçisidir.

Ancak açıklamalı etiketler Git veritabanında tam nesneler olarak depolanır. Bunlar sağlamalı (checksummed) verilerdir. Etiketi koyan kişinin adını, e-postasını ve etiketleme tarihini içerir, etiketleme mesajınız yer alır ve GNU Privacy Guard (GPG) ile imzalanıp, doğrulanabilir. Tüm bu bilgilere sahip olabilmeniz için genellikle açıklamalı etiketler oluşturmanız önerilir, ancak geçici bir etiket istiyorsanız veya herhangi bir nedenle diğer bilgileri saklamak istemiyorsanız, hafif etiketler de mevcuttur.

Git’te açıklamalı bir etiket oluşturmak basittir. En kolay yol, tag komutunu çalıştırdığınızda -a (annotated) bayrağı da belirtmektir:

-m (message) bayrağı etiketle birlikte saklanan bir etiketleme mesajı belirtir. Eğer bu etiket için bir mesaj belirtmezseniz Git, mesajı yazabilmeniz için otomatik olarak düzenleyicinizi başlatır.

Etiket verilerini git show komutunu kullanarak etiketlediğiniz katkıyla birlikte görebilirsiniz:

Bu katkı bilgisini göstermeden önce etiketleme bilgisini, etiketleme tarihini ve açıklama mesajını gösterir.

Katkıları etiketlemenin başka bir yolu da hafif (lightweight) etiketler kullanmaktır. Bu metodda "katkı sağlaması" dışında hiçbir veri saklanmaz. Hafif etiket oluşturmak için -a, -s veya -m seçeneklerinden hiçbirini kullanmaksızın sadece bir etiket adı yazarsınız:

Bu sefer etiket üzerinde git show komutunu çalıştırırsanız ekstra etiket bilgilerini göremezsiniz. Komut sadece katkıyı gösterir:

Katkıları, işledikten sonra da etiketleyebilirsiniz. Katkı geçmişinizin şöyle göründüğünü varsayalım:

Şimdi, projeyi ``updated rakefile`` katkısını işlerken "v1.2" şeklinde etiketlemeyi unuttuğunuzu varsayalım. Bunu sonradan da ekleyebilirsiniz. Bu katkıyı etiketlemek için, komutun sonunda katkı sağlamasının (checksum) tamamını veya bir kısmını belirtirsiniz:

Artık katkıyı etiketlediğinizi görebilirsiniz:

Varsayılan olarak git push komutu, etiketleri uzak sunuculara aktarmaz. Etiketleri oluşturduktan sonra paylaşıma açık bir sunucuya (shared server) göndermeniz gerekecektir. Bu süreç tıpkı uzak dalları paylaşmaya benzer: git push origin <tagname> komutunu çalıştırabilirsiniz (tagname: etiket adı).

Aynı anda göndermek istediğiniz çok sayıda etiketiniz varsa, git push komutunun yerine --tags seçeneğini de kullanabilirsiniz. Bu, tüm etiketlerinizi, halihazırda orada olmayan uzak sunucuya aktaracaktır.

Artık başka biri reponuzu kopyaladığında veya reponuzdan bilgi aldığında tüm etiketlerinizi de alacaktır.

Yerel reponuzdaki bir etiketi silmek için git tag -d <tagname> komutunu kullanabilirsiniz (tagname: etiket adı). Örneğin yukarıdaki hafif etiketimizi şu şekilde kaldırabiliriz:

Bunun, etiketi herhangi bir uzak sunucudan kaldırmadığını unutmayın. Uzak sunucudan etiket silmenin iki yaygın çeşidi vardır.

İlk yöntem git push <remote> :refs/tags/<tagname> komutudur (remote: uzak sunucu adı, tagname: etiket adı):

Aslında yaptığımız şey: uzak sunucudaki etiket adının üstüne boş (null) bir değer yazmaktır (":" dan önceki boşluğa dikkat edin). Böylece eski etiket silinecektir.

Uzak etiketi silmenin ikinci (ve daha sezgisel) yolu ise --delete <tagname> kullanmaktır (tagname: etiket adı):

Bir etiketin işaret ettiği sürümleri görüntülemek istiyorsanız, bu etiketi git checkout komutuyla kontrol edebilirsiniz. Ancak bunu yapmak reponuzu ``detached HEAD`` (ayrık uç) durumuna sokar ve bu da bazı olumsuz yan etkilere neden olur:

Normalde her bir dalda bir uç (HEAD) bulunur ve bu uç en son katkıya iliştirilmiştir. ``detached HEAD`` durumundayken bu uç en son katkı yerine etikete sabitlendiğinden, yeni bir katkı işleseniz bile katkıniz hiçbir dala ait olmayacağı için "katkı karması" (hash) dışında erişilemez olacaktır. Bu nedenle, değişiklik yapmanız gerekiyorsa (mesela eski bir sürümdeki bir hatayı düzelttiniz) yeni bir dal oluşturmanız gerekecektir:

Bunu yapıp bir katkı işlerseniz, "version2" dalınız, yeni değişikliklerinizle ilerleyeceği için "v2.0.0" etiketinizden biraz farklı olacaktır. Bu yüzden dikkatli olun.