Git Tag 기반 Single Source of Truth를 통한 버전 무결성 보장 설계

Context

package.json과 같이 매니페스트 파일 내에 버전 필드를 정의하는 기존 방식은 코드와 버전 정보 간의 불일치(Drift) 가능성을 내포함. 이를 해결하기 위해 Go는 파일 기반 버전 관리 체계를 완전히 배제한 설계 채택.

Technical Solution

• Git Tag를 Version의 Single Source of Truth로 정의하여 특정 버전이 항상 특정 Commit을 가리키는 구조 설계
• go.mod 내 버전 필드를 제거하여 매니페스트와 실제 코드 간의 정합성 불일치 문제 원천 차단
• Major Version 변경 시 Module Path에 버전 번호를 포함시키는 구조를 통해 동일 프로젝트의 서로 다른 메이저 버전 간 Coexistence 지원
• 태그가 없는 커밋에 대해 Timestamp와 Commit Hash를 조합한 Pseudo-version을 생성하여 빌드 추적성 유지
• runtime/debug 패키지를 통한 바이너리 내 빌드 정보 추출 및 GoReleaser 기반의 자동화된 배포 파이프라인 구성