[Git] 내 코드에 버전 도장 쾅! git tag로 배포 버전 관리하기

수많은 커밋 중에서 "이게 1.0 버전이었나? 아니면 그 다음 거였나?" 하고 헷갈린 적 없으신가요?
오늘 배울 git tag를 활용하면, 수만 개의 커밋 속에서도 우리가 배포한 버전들을 한눈에 찾아낼 수 있습니다.

 

1. Tag란 무엇인가요?

Tag는 특정 커밋에 붙이는 이름표입니다.
커밋 아이디(a1b2c3d...)는 사람이 읽기 어렵지만, 태그로 v1.0, v2.1 같은 이름을 붙여두면 나중에 해당 시점으로 돌아가거나 관리하기가 매우 쉬워집니다.

• Lightweight 태그: 단순히 이름만 붙이는 태그 (임시용)
• Annotated 태그 (추천): 작성자 이름, 이메일, 날짜, 메시지까지 포함하는 태그 (배포용)

 

2. 사용법 (실전 예제)

① 배포용 태그 만들기 (Annotated)

보통 실무에서는 이 방식을 사용합니다. -a(태그 이름)와 -m(메시지) 옵션을 사용합니다.

# v1.0.0 이라는 태그를 메시지와 함께 생성
git tag -a v1.0.0 -m "공식 1.0 버전 릴리즈"

② 태그 목록 확인하기

git tag

③ 태그 정보 자세히 보기

어떤 커밋에 어떤 메시지로 태그가 달렸는지 확인합니다.

git show v1.0.0

 

 

3. 원격 저장소(GitHub)에 태그 올리기

주의할 점은, 일반적인 git push로는 태그가 GitHub에 올라가지 않는다는 것입니다. 태그는 별도로 푸시해줘야 합니다.

# 특정 태그 하나만 올리기
git push origin v1.0.0

# 내가 만든 모든 태그를 한꺼번에 올리기
git push origin --tags

 

 

4. 태그가 있으면 좋은 점 (GitHub 활용)

GitHub에 태그를 푸시하면 [Releases] 탭에서 해당 버전의 소스 코드를 .zip 파일로 바로 다운로드할 수 있게 됩니다. 또한, 나중에 특정 버전에서 버그가 발생했을 때 태그 이름을 이용해 그 시점으로 즉시 이동할 수 있습니다.

# v1.0.0 태그 시점으로 코드 되돌려보기
git checkout v1.0.0

 

 

📝 요약

1. git tag: 특정 커밋에 버전을 표시하는 이름표를 단다.
2. Annotated 태그: 실무 배포 시 권장되며, 작성자 정보와 메시지를 포함한다.
3. Push: git push origin --tags 명령어로 GitHub에 공유해야 한다.