Git'te etiketler (tags) ve sürümler (releases) nasıl çalışır?

Question

Accepted Answer

**Etiketler**, geçmişteki belirli noktaları önemli olarak işaretler — tipik olarak **sürümler** (v1.0.0 gibi sürüm numaraları). Dallardan (branches) farklı olarak, etiketler hareket etmeyen sabit göstericilerdir ve sürüm etiketlemesi ile referans alınması için kullanılırlar. Versiyonlandırma ve sürüm yönetimi için merkezidir.

## Etiket oluşturma

```bash
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag (just a pointer, no metadata)
git tag v1.0.0

# tag a specific past commit
git tag -a v1.0.0 <commit> -m "..."
```

**Ek açıklama etiketleri** (sürümler için önerilen) meta veri (etiketleyen, tarih, mesaj) depolar; **hafif etiketler** sadece bir kammite işaret eden bir isimdir.

## Etiketlerle çalışma

```bash
git tag                        # list tags
git show v1.0.0                # show a tag and its commit
git checkout v1.0.0            # check out the code at a tag (detached HEAD)

# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0         # push a specific tag
git push origin --tags         # push all tags
```

Önemli: **etiketler `git push` ile otomatik olarak gönderilmez** — onları açık bir şekilde göndermeniz gerekir.

## Etiketler vs dallar

```text
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG    → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
```

## Anlamsal versiyonlandırma ve sürümler

```text
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
  MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
  (with release notes, built artifacts) for distribution.
```

## Neden önemli

Etiketleri ve sürümleri anlamak **versiyonlandırma ve sürüm yönetimi** için değerlidir, bu nedenle yayınlanan yazılımlarla çalışmak için yararlı pratik bilgidir. **Etiketler**, geçmişteki önemli noktaları işaretler — tipik olarak **sürüm versiyonları** (v1.0.0 gibi) — belirli kammitlere sabit, kalıcı referanslar sağlayarak, her sürümün hangi koddan oluştuğunun takip edilmesi ve referans alınması için gereklidir.

**Ek açıklama etiketleri** (sürümler için önerilen, etiketleyen, tarih ve mesaj gibi meta veriyi depolayan) ile **hafif etiketler** arasındaki farkı anlamak, uygun sürüm etiketlemesi için pratik bilgidir.

Etiketleri oluşturmayı, listelemeyi ve kontrol etmeyi bilmek ve önemlisi **etiketlerin otomatik olarak gönderilmediğini** (açık `git push origin --tags` veya belirli etiketleri göndermeyi gerektirdiğini — insanların etiket oluşturduğu ama göndermeyi unuttuğu yaygın bir tuzaktır), sürüm etiketlerini doğru şekilde yönetmek için gereklidir.

**Etiketler vs dallar** (bir etiket, belirli bir kammite yapılan sabit bir göstericidir — hareket etmeyen kalıcı bir etiket — bir dal ise geliştirmeyle ilerleyen hareketli bir göstericisidir) arasındaki farkı anlamak, onların farklı rollerini açıklığa kavuşturur: sürümleri/kilometre taşlarını kalıcı olarak işaretlemek için etiketler, devam eden çalışma için dallar.

**Anlamsal versiyonlandırma** ile bağlantıyı (değişikliklerin doğasını iletmek için MAJOR.MINOR.PATCH kuralları) ve platformların **Sürümleri** etiketlerden nasıl oluşturduğunu (sürüm notları ve dağıtım için yapıtlarla) anlamak, etiketlerin gerçek sürüm yönetiminde nasıl yer aldığını yansıtır.

Yazılımı sürümlemek ve versiyonlandırmak yaygın bir ihtiyaç olduğu ve etiketler sürüm versiyonlarını işaretlemek ve referans almak için Git mekanizması olduğu (sürüm yönetiminin merkezi ve platformların sürüm özellikleriyle entegre) için, etiketleri ve sürümleri anlamak — ek açıklama etiketleri vs hafif etiketler, onları göndermek, etiketler vs dallar ve versiyonlandırma/sürümlerdeki rolleri — yayınlanan yazılımları yönetmek için değerli, pratik olarak ilgili Git bilgisidir, versiyonlandırma kuralları ve sürüm süreçleriyle bağlantılı profesyonel geliştirmenin yararlı bir yönü.