Bagaimana tag dan release berfungsi dalam Git?

Question

Accepted Answer

**Tag** menandakan titik tertentu dalam sejarah sebagai penting — biasanya **release** (versi seperti v1.0.0). Tidak seperti cawangan (branch), tag ialah penunjuk tetap yang tidak bergerak, digunakan untuk melabel dan merujuk versi release. Ia penting dalam pengurusan versi dan release.

## Mencipta tag

```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 "..."
```

**Annotated tag** (disyorkan untuk release) menyimpan metadata (tagger, tarikh, mesej); **lightweight tag** hanyalah satu nama yang menunjuk ke satu commit.

## Bekerja dengan tag

```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
```

Penting: **tag tidak ditolak (push) secara automatik** dengan `git push` — anda menolaknya secara eksplisit.

## Tag berbanding cawangan

```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.
```

## Versi semantik dan release

```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.
```

## Mengapa ia penting

Memahami tag dan release amat bernilai untuk **pengurusan versi dan release**, jadi ia merupakan pengetahuan praktikal yang berguna untuk bekerja dengan perisian yang telah dikeluarkan. **Tag** menandakan titik penting dalam sejarah — biasanya **versi release** (seperti v1.0.0) — menyediakan rujukan tetap dan kekal kepada commit tertentu, yang penting untuk menjejak dan merujuk kod yang membentuk setiap release.

Memahami perbezaan antara **annotated tag** (disyorkan untuk release, menyimpan metadata seperti tagger, tarikh, dan mesej) dan lightweight tag ialah pengetahuan praktikal untuk pengetagan release yang betul.

Mengetahui cara mencipta, menyenarai, dan checkout tag, dan yang penting bahawa **tag tidak ditolak secara automatik** (memerlukan `git push origin --tags` secara eksplisit atau menolak tag tertentu — satu kesilapan biasa apabila orang mencipta tag tetapi terlupa untuk menolaknya), adalah perlu untuk menguruskan tag release dengan betul.

Memahami **tag berbanding cawangan** (tag ialah penunjuk tetap kepada commit tertentu — label kekal yang tidak bergerak — manakala cawangan ialah penunjuk yang boleh bergerak yang berkembang dengan pembangunan) menjelaskan peranan berbeza mereka: tag untuk menanda release/peristiwa penting secara kekal, cawangan untuk kerja yang berterusan.

Memahami kaitan dengan **versi semantik** (konvensyen MAJOR.MINOR.PATCH untuk menyampaikan sifat perubahan) dan cara platform membina **Release** daripada tag (dengan nota release dan artifak untuk pengedaran) mencerminkan cara tag sesuai dalam pengurusan release sebenar.

Memandangkan mengeluarkan dan mengurus versi perisian ialah keperluan yang biasa dan tag ialah mekanisme Git untuk menandakan dan merujuk versi release (penting dalam pengurusan release dan diintegrasikan dengan ciri release platform), memahami tag dan release — annotated berbanding lightweight tag, menolaknya, tag berbanding cawangan, dan peranannya dalam versi/release — adalah pengetahuan Git yang bernilai dan relevan secara praktikal untuk menguruskan perisian yang dikeluarkan, satu aspek berguna dalam pembangunan profesional yang berkaitan dengan konvensyen versi dan proses release.