Git tag

새 태그를 만들려면 다음 명령을 실행합니다.

시맨틱 식별자가 있는 < tagname >을 태그가 만들어지는 시점의 리포지토리 상태로 바꿉니다. 일반적인 패턴은 git tag v1.4와 같이 버전 번호를 사용하는 것입니다. Git은 두 가지 유형의 태그(주석 태그 및 경량 태그)를 지원합니다. 이전 예시에서는 경량 태그를 만들었습니다. 경량 태그와 주석 태그는 저장하는 메타데이터의 양이 다릅니다. 가장 좋은 방법은 주석 태그를 공개로, 경량 태그를 비공개로 간주하는 것입니다. 주석 태그에는 태거 이름, 이메일 및 날짜와 같은 추가 메타데이터가 저장됩니다. 이것은 공개 릴리스를 위한 중요한 데이터입니다. 경량 태그는 기본적으로 커밋에 대한 '북마크'로, 커밋에 대한 이름이자 포인터일 뿐이며 관련 커밋으로 연결되는 빠른 링크를 만드는 데 유용합니다.

이 명령을 실행하면 v1.4-lw로 식별되는 경량 태그가 만들어집니다. 경량 태그는 -a, -s 또는 -m 옵션 없이 만들어집니다. 경량 태그는 새 태그 체크섬을 만들어 프로젝트 리포지토리의 .git/ 디렉터리에 저장합니다.

리포지토리에 저장된 태그를 나열하려면 다음을 실행합니다.

그러면 태그 목록이 출력됩니다.

태그 목록을 세분화하려면 -l 옵션을 와일드카드 표현식으로 전달하면 됩니다.

이전 예시에서는 -l 옵션 및 -rc 접두사로 표시된 모든 태그 목록을 반환하는 와일드카드 표현식 -rc를 사용합니다. 이는 일반적으로 릴리스 후보를 식별하는 데 사용됩니다.

이전 태그 예시에서는 암시적 커밋에 대한 작업을 보여주었습니다. 기본적으로 git tag는 HEAD가 참조하는 커밋에 태그를 만듭니다. 또는 git tag를 특정 커밋에 참조로 전달할 수도 있습니다. 이렇게 하면 기본적으로 HEAD가 아닌 전달된 커밋에 태그가 지정됩니다. 이전 커밋 목록을 수집하려면 git log 명령을 실행합니다.

git log를 실행하면 커밋 목록이 출력됩니다. 이 예시에서는 새 태그에 대해 가장 많이 사용되는 커밋 Merge branch 'feature'를 선택하겠습니다. Git에 전달할 커밋 SHA 해시를 참조해야 합니다.

위의 git tag 호출을 실행하면 이전 git log 예시에서 선택한 커밋에 대해 v1.2로 식별되는 새 주석 커밋이 만들어집니다.

기존 태그와 동일한 식별자로 태그를 만들려는 경우 Git에서 다음과 같은 오류 메시지를 표시합니다.

또한 기존 태그 식별자로 이전 커밋에 태그를 지정하려고 하면 Git에서 동일한 오류 메시지를 표시합니다.

기존 태그를 업데이트해야 하는 경우에는 -f FORCE 옵션을 사용해야 합니다.

위 명령을 실행하면 15027957951b64cf874c3557a0f3547bd83b3ff6 커밋이 v1.4 태그 식별자에 매핑됩니다. v1.4 태그의 기존 콘텐츠를 재정의합니다.

태그 공유는 브랜치 푸시와 비슷합니다. 기본적으로 git push는 태그를 푸시하지 않습니다. git push로 태그를 명시적으로 전달해야 합니다.

여러 태그를 동시에 푸시하려면 --tags 옵션을 git push 명령으로 전달합니다. 다른 사용자가 리포지토리를 복제하거나 풀하면 새 태그를 받게 됩니다.

You can view the state of a repo at a tag by using the git checkout command.

위 명령으로 v1.4 태그를 체크아웃합니다. 그러면 리포지토리가 분리된 HEAD 상태가 됩니다. 어떤 변경 사항도 태그를 업데이트하지 않는다는 뜻입니다. 새 분리된 커밋을 만들 것입니다. 이 새 분리된 커밋은 어떤 브랜치에도 속하지 않고 커밋 SHA 해시를 통해서만 직접 연결할 수 있습니다. 따라서 분리된 HEAD 상태에서 변경할 때마다 새 브랜치를 만드는 것이 가장 좋습니다.

브랜치 삭제는 간단한 작업입니다. -d 옵션 및 태그 식별자를 git tag에 전달하면 식별된 태그가 삭제됩니다.

이 예시에서는 git tag를 실행하여 v1, v2, v3을 보여주는 태그 목록을 표시한 다음 git tag -d v1을 실행하여 v1 태그를 삭제합니다.

To recap, Tagging is an additional mechanism used to create a snap shot of a Git repo. Tagging is traditionally used to create semantic version number identifier tags that correspond to software release cycles. The git tag command is the primary driver of tag: creation, modification and deletion. There are two types of tags; annotated and lightweight. Annotated tags are generally the better practices as they store additional valuable meta data about the tag. Additional Git commands covered in this document were git push, and git checkout. Visit their corresponding pages for discussion on their extended use.