3-2. Git의 tag: 릴리스 관리

1. 태그(Tag)의 개념과 역할: 릴리스 버전을 위한 레이블

Git의 tag는 특정 시점의 커밋에 붙이는 고정된 레이블입니다. 마치 책갈피처럼, 프로젝트의 특정 상태를 표시하고, 나중에 해당 상태로 쉽게 돌아갈 수 있게 해줍니다. 브랜치가 가변적인 포인터와 같다면, 태그는 불변의 스냅샷이라고 할 수 있습니다. 특히, 소프트웨어 릴리스(release) 버전을 관리하는 데 매우 중요합니다.

💡 비유: 태그는 마치 사진 앨범에서 특정 사진에 "v1.0 릴리스"와 같은 라벨을 붙이는 것과 같습니다. 나중에 해당 릴리스 버전을 다시 확인하거나, 롤백(rollback)해야 할 때, 이 라벨을 통해 정확한 시점으로 돌아갈 수 있습니다.

1) 태그의 중요성: 릴리스 관리의 핵심

소프트웨어 개발에서 릴리스 관리는 매우 중요한 부분입니다. 릴리스란, 개발된 소프트웨어를 사용자에게 배포할 수 있는 상태로 만드는 과정을 의미합니다. 릴리스 버전은 소프트웨어의 기능, 안정성, 성능 등을 나타내며, 사용자는 릴리스 버전을 통해 소프트웨어를 사용하고 업데이트합니다.

태그는 이러한 릴리스 버전을 관리하는 데 핵심적인 역할을 합니다.

• 버전 표시: 릴리스 버전을 명확하게 식별할 수 있도록 합니다(예: v1.0, v1.2.3).
• 히스토리 보존: 특정 릴리스 시점의 코드 상태를 영구적으로 보존합니다.
• 롤백 용이성: 문제가 발생했을 때, 이전 릴리스 버전으로 쉽게 롤백할 수 있도록 돕습니다.
• 협업 효율성: 팀원 간의 릴리스 버전에 대한 명확한 소통을 가능하게 합니다.

2) 태그의 종류: Lightweight vs. Annotated

Git 태그는 크게 두 가지 종류로 나뉩니다.

• Lightweight Tag (가벼운 태그): 단순히 특정 커밋을 가리키는 포인터입니다. 추가적인 정보는 포함하지 않습니다. 가볍고 생성 속도가 빠르지만, 태그에 대한 추가적인 정보(태그 작성자, 메시지 등)를 저장할 수 없습니다.

  bash git tag v1.0 <커밋 해시>

• Annotated Tag (주석이 달린 태그): 태그 작성자, 태그 메시지, 날짜, 서명 등의 정보를 포함합니다. 보다 공식적인 릴리스에 사용되며, 안정성을 높이기 위해 권장됩니다.

  bash git tag -a v1.0 -m "첫 번째 릴리스" <커밋 해시>

2. 태그 생성 및 사용 방법

1) 태그 생성: git tag 명령어

git tag 명령어를 사용하여 태그를 생성합니다. 앞서 설명했듯이, 태그 종류에 따라 옵션을 달리 사용합니다.

• Lightweight Tag 생성: 현재 브랜치의 최신 커밋에 태그를 생성합니다.

  bash git tag v1.0

  특정 커밋에 태그를 지정하려면, 커밋 해시를 명시해야 합니다.

  bash git tag v1.0 <커밋 해시>

• Annotated Tag 생성: -a 옵션을 사용하여 Annotated Tag를 생성합니다. -m 옵션으로 태그 메시지를 추가할 수 있습니다.

  bash git tag -a v1.0 -m "첫 번째 릴리스"

  특정 커밋에 Annotated Tag를 생성하는 경우, 커밋 해시를 지정합니다.

  bash git tag -a v1.0 -m "첫 번째 릴리스" <커밋 해시>

2) 태그 목록 확인: git tag 명령어

git tag 명령어를 옵션 없이 사용하면, 현재 저장소의 모든 태그 목록을 알파벳 순으로 표시합니다.

```bash
git tag
```

태그 메시지를 포함하여 상세 정보를 확인하려면, `-n` 옵션을 사용합니다.

```bash
git tag -n
```

특정 패턴의 태그만 확인하려면, 패턴을 지정합니다.

```bash
git tag "v1.*"  # v1.0, v1.1, v1.2 등 v1으로 시작하는 모든 태그
```

3) 태그 확인: git show 명령어

git show 명령어를 사용하면, 특정 태그에 대한 상세 정보를 확인할 수 있습니다.

```bash
git show v1.0
```

Annotated Tag의 경우, 태그 작성자, 태그 메시지, 태그 날짜, 태그가 가리키는 커밋 정보를 확인할 수 있습니다. Lightweight Tag는 커밋 정보만 표시됩니다.

4) 태그를 사용하여 코드 확인: git checkout 명령어

태그는 특정 시점의 코드를 확인하는 데 사용될 수 있습니다. git checkout 명령어를 사용하여 해당 태그가 가리키는 커밋으로 이동할 수 있습니다.

```bash
git checkout v1.0
```

이 경우, detached HEAD 상태가 되므로, 변경 사항을 수정하고 싶다면 새로운 브랜치를 생성해야 합니다.

```bash
git checkout -b release-v1.0 v1.0
```

5) 태그 삭제: git tag -d 명령어

더 이상 필요하지 않은 태그는 삭제할 수 있습니다. -d 옵션을 사용하여 삭제합니다.

```bash
git tag -d v1.0
```

> ⚠️ **주의**: 원격 저장소에 푸시된 태그를 삭제하려면, `git push origin --delete <tagname>` 명령어를 사용해야 합니다.

6) 태그 푸시: git push 명령어

기본적으로 git push 명령어는 로컬에 생성된 태그를 원격 저장소에 푸시하지 않습니다.

• 개별 태그 푸시: 특정 태그를 원격 저장소에 푸시합니다.

  bash git push origin v1.0

• 모든 태그 푸시: 모든 태그를 원격 저장소에 푸시합니다.

  bash git push origin --tags

3. 태그를 활용한 릴리스 관리 전략

1) SemVer (Semantic Versioning)

SemVer는 소프트웨어 버전을 표현하기 위한 표준입니다. MAJOR.MINOR.PATCH 형식으로 표현되며, 각 숫자는 다음과 같은 의미를 가집니다.

• MAJOR: 호환성이 깨지는 변경 사항이 있는 경우 증가합니다.
• MINOR: 하위 호환성을 유지하면서 새로운 기능이 추가된 경우 증가합니다.

• PATCH: 버그 수정과 같은 하위 호환성을 유지하는 변경 사항이 있는 경우 증가합니다.

  v1.2.3 # MAJOR: 1, MINOR: 2, PATCH: 3

2) 릴리스 워크플로우 예시

다음은 태그를 활용한 릴리스 워크플로우의 일반적인 예시입니다.

1. 개발: 새로운 기능 개발 또는 버그 수정 작업은 브랜치에서 진행됩니다.
2. 릴리스 준비: 릴리스를 준비하기 위해, develop 브랜치에서 릴리스 브랜치를 생성합니다. 이 브랜치에서 릴리스와 관련된 최종 테스트, 문서 업데이트, 릴리스 노트 작성 등을 수행합니다.
3. 릴리스 태깅: 릴리스 브랜치에서 릴리스 준비가 완료되면, SemVer를 사용하여 태그를 생성합니다. (예: git tag -a v1.0.0 -m "릴리스 v1.0.0")
4. 병합: 릴리스 브랜치를 main 브랜치와 develop 브랜치에 병합합니다.
5. 배포: 생성된 태그를 기반으로 소프트웨어를 배포합니다.

3) 릴리스 노트

릴리스 노트는 릴리스 버전에 대한 변경 사항, 새로운 기능, 수정된 버그, 알려진 문제 등을 설명하는 문서입니다. 태그와 함께 릴리스 노트를 작성하면, 사용자들이 릴리스 버전에 대한 정보를 쉽게 얻을 수 있습니다.

4. 실전 예제: 간단한 릴리스 프로세스

다음은 간단한 릴리스 프로세스의 예시입니다.

1. 새로운 기능 개발 및 커밋: 새로운 기능을 개발하고 커밋합니다.

   ```bash git checkout -b feature/new-feature

   ... 코드 작성 ...

   git add . git commit -m "feat: 새로운 기능 추가" git push origin feature/new-feature ```

2. develop 브랜치로 병합: 개발된 기능을 develop 브랜치에 병합합니다.

   bash git checkout develop git merge feature/new-feature git push origin develop

3. 릴리스 브랜치 생성: develop 브랜치에서 릴리스 브랜치를 생성합니다.

   bash git checkout -b release/v1.1.0

4. 릴리스 준비: 릴리스 브랜치에서 최종 테스트를 수행하고, 릴리스 노트를 작성합니다.

   ```bash

   ... 테스트 수행 ...

   ... 릴리스 노트 작성 ...

   ```

5. 태그 생성: release/v1.1.0 브랜치에서 v1.1.0 태그를 생성합니다.

   bash git tag -a v1.1.0 -m "릴리스 v1.1.0"

6. main 브랜치로 병합: release/v1.1.0 브랜치를 main 브랜치에 병합합니다.

   bash git checkout main git merge release/v1.1.0 git push origin main

7. develop 브랜치로 병합: release/v1.1.0 브랜치를 develop 브랜치에 병합합니다.

   bash git checkout develop git merge release/v1.1.0 git push origin develop

8. 태그 푸시: 생성된 태그를 원격 저장소에 푸시합니다.

   bash git push origin v1.1.0

5. 주의사항 및 고급 활용

1) 태그 생성 시점

태그는 릴리스 준비가 완료된 시점에 생성해야 합니다. 릴리스 브랜치에서 테스트, 문서 업데이트 등의 작업을 수행한 후, 태그를 생성하는 것이 일반적입니다.

2) 태그 메시지

태그 메시지는 릴리스에 대한 간략한 설명을 포함해야 합니다. 태그 메시지는 릴리스 노트를 대신할 수 있으므로, 구체적이고 명확하게 작성하는 것이 좋습니다.

3) 태그 공유

로컬에서 생성된 태그는 기본적으로 원격 저장소에 푸시되지 않습니다. git push origin --tags 명령어를 사용하여 모든 태그를 원격 저장소에 푸시하거나, git push origin <tagname> 명령어를 사용하여 특정 태그를 푸시해야 합니다.

4) 태그 수정

태그는 생성된 후 수정하는 것이 권장되지 않습니다. 태그는 변경 불가능한 스냅샷을 나타내기 때문입니다. 만약 태그를 수정해야 하는 상황이 발생한다면, 새로운 태그를 생성하고, 기존 태그를 삭제하는 것이 좋습니다.

5) 서명된 태그 (Signed Tags)

보안을 강화하기 위해, GPG(GNU Privacy Guard)를 사용하여 서명된 태그를 생성할 수 있습니다. 서명된 태그는 태그의 진위 여부를 확인할 수 있도록 합니다.

• 서명된 태그 생성: -s 옵션을 사용합니다.

  bash git tag -s v1.0 -m "서명된 릴리스"

• 서명된 태그 확인: git verify-tag 명령어를 사용하여 태그의 서명을 확인합니다.

  bash git verify-tag v1.0

6) 태그 사용 팁

• 자동화: 릴리스 프로세스를 자동화하여, 태그 생성, 병합, 푸시 등을 스크립트 또는 CI/CD 파이프라인으로 처리할 수 있습니다.
• 태그 기반 배포: 태그를 사용하여, 특정 릴리스 버전을 서버에 배포할 수 있습니다.
• Gitflow: Gitflow 워크플로우를 사용하면, 릴리스 관리를 위한 브랜치 모델과 프로세스를 체계적으로 관리할 수 있습니다. (자세한 내용은 [4-1. Git의 workflow: Gitflow 소개]에서 다룹니다.)

6. 결론

Git의 태그는 소프트웨어 릴리스 관리에 필수적인 기능입니다. 태그를 사용하여 특정 시점의 코드를 고정하고, 릴리스 버전을 명확하게 관리할 수 있습니다. SemVer, 릴리스 워크플로우, 릴리스 노트 등을 활용하여, 더욱 효율적인 릴리스 프로세스를 구축할 수 있습니다.

태그의 개념, 종류, 생성 및 사용 방법, 릴리스 관리 전략 등을 이해하고, 실전 예제를 통해 태그를 활용하는 방법을 익히면, 여러분의 소프트웨어 개발 생산성을 향상시키는 데 큰 도움이 될 것입니다.