태그를 기준으로 배포하는 방법

태그를 기준으로 배포하는 방법

본 문서는 Git 태그를 기준으로 애플리케이션 배포를 관리하는 방법에 대해 설명합니다. 이 방식은 특정 버전의 배포를 명확히 관리할 수 있으며, 특히 프로덕션 환경의 핫픽스 및 안정적인 릴리스 관리에 유용합니다.

📌 핵심 GitHub Action 설정 (deploy.yml)

아래는 태그 기준으로 실행되는 GitHub Action의 핵심 부분입니다:

on:
  push:
    tags:
      - 'v[0-9]+.[0-9]+.[0-9]+'

이 설정은 vX.Y.Z 형태의 태그가 원격 저장소에 푸시되었을 때만 CI/CD 파이프라인을 실행하도록 합니다.

🚩 사례: v1.7 개발 중 v1.6 핫픽스 배포하기

현재 상황:

• main 브랜치에서 v1.7.0이 개발 중이었으나, 긴급하게 v1.6.15에 대한 핫픽스가 필요합니다.

단계별 작업 방법

1. 핫픽스 브랜치 생성하기

git checkout -b release/v1.6 v1.6.15

2. 핫픽스 작업 및 커밋하기

핫픽스 변경 사항을 적용 후 커밋합니다:

git commit -am "fix: critical bug fix for production"

3. 태그 생성하기

이제 새로운 태그(v1.6.16)를 생성하여 핫픽스 버전을 명확히 표시합니다:

git tag v1.6.16

4. 원격 저장소에 푸시하기

브랜치와 태그를 원격 저장소로 푸시하여 CI/CD 파이프라인을 트리거합니다:

git push origin release/v1.6
git push origin v1.6.16  # 태그를 푸시하는 순간 배포 파이프라인 실행

이 태그 푸시가 CI/CD 파이프라인의 실행을 트리거하여 AWS Elastic Beanstalk나 다른 배포 환경으로 코드가 배포됩니다.

🎯 확인 사항

• 배포 파이프라인은 오직 태그 푸시를 기준으로 실행됩니다.

• 긴급 핫픽스 및 이전 버전 유지보수 시, 브랜치 전략과 태그 전략을 함께 활용하면 버전 관리가 명확해집니다.

이 방법을 통해 릴리스 및 핫픽스 관리가 효율적이고 명확하게 이루어질 수 있습니다.