Git Tag와 Semantic Versioning을 기반으로 버전을 기록해봅니다. 기록한 Tag로 Github에서 Release를 생성하는 실습을 진행합니다.

실습 준비

해당 실습 자료는 4. Pre-commit 으로 코드 포맷팅 자동화 하기에서 이어집니다.

1. Git Tag 작성하기

   • Git Tag는 git tag {tag name} 명령어로 생성할 수 있습니다.

     • -a 옵션으로 Tag를 생성한 유저, 이메일, 생성 날짜, 메시지 등을 함께 기록하는 Annotated Tag를 생성할 수 있습니다.

   • 먼저 main 브랜치로 변경 후 git pull 명령어를 통해 새로운 업데이트 사항을 Local Repository로 받아옵니다.

     

   • git tag v0.1.0 명령어로 초기 버전을 작성 합니다.

     • 최초 버전이므로 v0.1.0으로 시작합니다.

     

     • git log 명령어로 가장 최신 Commit에 Tag가 생성된 것을 확인할 수 있습니다.

       

   1. Git Tag 업로드 하기

      • 생성한 Git Tag를 Github Repository에 Push 합니다.

        • 브랜치를 Push 할 때와 동일하게 git push v0.1.0 명령어로 처리할 수 있습니다.

        

      • 업로드 된 Tag를 Github Repository에서 확인해봅니다.

        • 1 Tags 로 표시된 것을 확인할 수 있습니다.

        

      • 다음과 같이 업로드된 Tag를 확인할 수 있습니다.

        • 해당 Tag를 기준으로 zip 혹은 tar.gz 으로 소스코드를 다운 받을 수 있습니다.

        

   2. Release 생성하기

      • Git Tag를 생성했으니 Release를 생성 해보겠습니다.

        • 우측 중간의 Releases에서 Create a new release 버튼을 클릭하거나, Releases를 클릭하면 Release 페이지로 이동합니다.

        

      • 해당 페이지에서 새로운 Release를 생성할 수 있습니다.

        

      • Choose a tag 버튼으로 v0.1.0 Tag를 선택합니다.

        

      • Release의 제목, 내용은 개발자가 직접 적거나 Generate release notes 버튼을 눌러 자동으로 작성할 수 있습니다.

        • Generate release notes 버튼으로 자동 입력하는 경우 이전 Release 와 현재 Release 사이에 추가된 Pull Request의 이름이 포함됩니다.

        

      • Set a a pre-release 로 Pre-Release를 만들 수도 있습니다.

        

      • Publish release, Save draft를 마무리할 수 있습니다.

        • Publish release - Release 생성
        • Save draft - Release 초안 생성

        

      • Github Repository의 메인 페이지로 돌아가면 다음과 같이 Release가 추가된 것을 확인할 수 있습니다.