버전 태그와 릴리즈 만들기

언제 사용하나

배포 시점을 표시하고 되돌아갈 수 있는 버전 태그를 남길 때.

실행 전 확인

• 버전 규칙(예: SemVer vMAJOR.MINOR.PATCH)을 정한다.
• 태그를 붙일 커밋이 맞는지 확인한다.

명령

# 주석 있는 태그 생성(권장)
git tag -a {{VERSION}} -m "{{RELEASE_NOTE}}"

# 특정 과거 커밋에 태그
git tag -a {{VERSION}} {{COMMIT}} -m "{{RELEASE_NOTE}}"

# 원격으로 태그 push
git push origin {{VERSION}}

# 태그 목록/정보 확인
git tag --list
git show {{VERSION}}

placeholder 설명

• {{VERSION}} : 버전 태그 (예: v1.4.0)
• {{RELEASE_NOTE}} : 태그 메시지
• {{COMMIT}} : 태그를 붙일 커밋

입력 예시

git tag -a v1.4.0 -m "결제 안정화 릴리즈"

기대 결과

버전이 태그로 남고 원격에서도 조회·체크아웃할 수 있다.

검증 방법

git show v1.4.0으로 태그가 올바른 커밋을 가리키는지 확인한다.

주의사항과 흔한 실수

• 이미 push한 태그를 옮기면 혼란을 준다(새 버전을 발행).
• 가벼운 태그보다 주석 태그(-a)가 정보가 많아 권장된다.

관련 문서

• git tag: https://git-scm.com/docs/git-tag