git tag 릴리스 운영 가이드: 버전 태깅, 주석 태그, 배포 추적 실무 방법

git tag 릴리스 운영 가이드: 버전 태깅, 주석 태그, 배포 추적 실무 방법

git tag는 배포 버전을 고정하고 변경 이력을 추적하는 기준점이다. CI/CD와 연결하면 롤백과 감사 대응이 훨씬 쉬워진다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

공식 Git 로고 (출처: git-scm.com)

git tag 기본 사용 패턴

git tag -a v1.8.0 -m "release: payment retry policy"
git push origin v1.8.0

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
-a	annotated tag 생성	작성자/설명을 포함한 정식 릴리스 태그를 만들 때
-m	태그 메시지 지정	릴리스 노트를 간단히 함께 남길 때
-d	로컬 태그 삭제	잘못 만든 태그를 정리할 때
--list	태그 목록 조회	배포 이력을 버전별로 확인할 때
push origin --tags	원격으로 태그 전송	배포 파이프라인이 태그 기반일 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: 운영 이슈 발생 시 어떤 코드가 배포됐는지 추적이 어렵다.
원인: 릴리스 시 태그를 남기지 않았다.
해결: 배포마다 annotated tag를 생성하고 릴리스 노트를 연결한다.
예방 팁: CI에서 태그 없는 배포를 차단하는 규칙을 둔다.

참고/출처

공식 문서: git-tag manual
공식 문서: Pro Git - Tagging
신뢰 자료: GitHub Docs - Managing releases