Git에서 tag와 릴리스는 어떻게 작동하나요?

Question

Accepted Answer

**tag**는 히스토리의 특정 지점을 중요한 것으로 표시합니다. 일반적으로 **릴리스**(v1.0.0 같은 버전)입니다. branch와 달리 tag는 움직이지 않는 고정 포인터로, 릴리스 버전을 레이블링하고 참조하는 데 사용됩니다. tag는 버전 관리와 릴리스 관리의 중심입니다.

## tag 생성

```bash
# annotated tag(릴리스에 권장 — 메타데이터 포함: 태거, 날짜, 메시지)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag(단지 포인터, 메타데이터 없음)
git tag v1.0.0

# 특정 과거 commit에 tag
git tag -a v1.0.0 <commit> -m "..."
```

**annotated tag**(릴리스에 권장)는 메타데이터(태거, 날짜, 메시지)를 저장하고, **lightweight tag**는 단지 commit을 가리키는 이름입니다.

## tag 다루기

```bash
git tag                        # tag 목록
git show v1.0.0                # tag와 그 commit 표시
git checkout v1.0.0            # tag의 코드 checkout(detached HEAD)

# tag는 기본적으로 push되지 않음 — 명시적으로 push:
git push origin v1.0.0         # 특정 tag push
git push origin --tags         # 모든 tag push
```

중요: **tag는 `git push`로 자동 push되지 않습니다**. 명시적으로 push해야 합니다.

## tag vs branch

```text
BRANCH → commit할 때 전진하는 이동 가능한 포인터(진행 중인 개발)
TAG    → 특정 commit을 가리키는 고정 포인터(영구 레이블 — 움직이지 않음)
→ tag는 릴리스/마일스톤을 영구히 표시; branch는 진행 중인 작업.
```

## 시맨틱 버저닝과 릴리스

```text
시맨틱 버저닝(SemVer): MAJOR.MINOR.PATCH(예: v2.3.1)
  MAJOR → 호환성 깨는 변경 | MINOR → 새 기능(호환) | PATCH → 버그 수정
→ tag가 이 버전들을 레이블링. 플랫폼(GitHub)은 tag로부터 "Release"를 빌드
  (릴리스 노트, 빌드 산출물과 함께) 배포용.
```

## 왜 중요한가

tag와 릴리스를 이해하는 것은 **버전 관리와 릴리스 관리에** 가치 있으므로, 릴리스된 소프트웨어를 다루는 데 유용한 실무 지식입니다. **tag**는 히스토리의 중요한 지점 — 일반적으로 **릴리스 버전**(v1.0.0 같은) — 을 표시하여 특정 commit에 대한 고정되고 영구적인 참조를 제공하며, 이는 어떤 코드가 각 릴리스를 구성하는지 추적하고 참조하는 데 필수적입니다.

**annotated tag**(릴리스에 권장, 태거, 날짜, 메시지 같은 메타데이터 저장)와 lightweight tag의 구분을 이해하는 것은 적절한 릴리스 태깅을 위한 실무 지식입니다.

tag를 생성, 목록 조회, checkout하는 방법과, 중요하게 **tag가 자동으로 push되지 않는다**(명시적인 `git push origin --tags` 또는 특정 tag push가 필요 — 사람들이 tag를 만들고 push를 잊는 흔한 함정)는 점을 아는 것은 릴리스 tag를 올바르게 관리하는 데 필요합니다.

**tag vs branch**(tag는 특정 commit을 가리키는 고정 포인터 — 움직이지 않는 영구 레이블 — 인 반면 branch는 개발과 함께 전진하는 이동 가능한 포인터)를 이해하면 그 다른 역할이 명확해집니다. tag는 릴리스/마일스톤을 영구히 표시하고, branch는 진행 중인 작업을 위한 것입니다.

**시맨틱 버저닝**(변경의 성격을 전달하기 위한 MAJOR.MINOR.PATCH 관례)과의 연결, 그리고 플랫폼이 tag로부터 (배포용 릴리스 노트와 산출물과 함께) **Release**를 빌드하는 방식을 이해하는 것은 tag가 실제 릴리스 관리에 어떻게 들어맞는지 반영합니다.

소프트웨어를 릴리스하고 버전 관리하는 것은 흔한 필요이고 tag는 릴리스 버전을 표시하고 참조하는 Git 메커니즘(릴리스 관리의 중심이자 플랫폼의 릴리스 기능과 통합됨)이므로, tag와 릴리스를 이해하는 것 — annotated vs lightweight tag, push, tag vs branch, 버전 관리/릴리스에서의 역할 — 은 릴리스된 소프트웨어를 관리하기 위한 가치 있고 실무적으로 관련된 Git 지식입니다. 이는 버전 관리 관례와 릴리스 프로세스에 연결된 전문 개발의 유용한 측면입니다.