CI/CD 파이프라인 구축

# .github/workflows/main.yml
name: NestJS CI/CD Pipeline

# 이 워크플로우를 트리거할 이벤트 정의
on:
  push:
    branches:
      - main # main 브랜치에 푸시될 때 워크플로우 실행
  pull_request:
    branches:
      - main # main 브랜치로 풀 리퀘스트가 열릴 때도 실행 (선택 사항)

# 환경 변수 정의 (전역 또는 스텝별)
env:
  NODE_VERSION: '20' # 사용할 Node.js 버전
  DOCKER_IMAGE_NAME: nestjs-app # Docker 이미지 이름
  DOCKER_REGISTRY: docker.io # Docker Hub 레지스트리

jobs:
  # 1. 빌드 및 테스트 (CI)
  build-and-test:
    runs-on: ubuntu-latest # 워크플로우를 실행할 가상 환경 (GitHub 호스팅 러너)

    steps:
      - name: Checkout repository # 레포지토리 코드 체크아웃
        uses: actions/checkout@v4

      - name: Set up Node.js # Node.js 환경 설정
        uses: actions/setup-node@v4
        with:
          node-version: ${{ env.NODE_VERSION }}
          cache: 'npm' # npm 캐싱 활성화 (의존성 설치 속도 향상)

      - name: Install dependencies # 의존성 설치
        run: npm ci

      - name: Run unit and integration tests # 단위 및 통합 테스트 실행
        run: npm run test

      # 2. Docker 이미지 빌드 및 푸시 (CD - Delivery)
      # 테스트가 성공해야 다음 단계로 진행
      - name: Log in to Docker Hub # Docker Hub 로그인
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push Docker image # Docker 이미지 빌드 및 푸시
        uses: docker/build-push-action@v5
        with:
          context: . # Dockerfile이 있는 경로
          push: true # 이미지 푸시 활성화
          tags: ${{ env.DOCKER_REGISTRY }}/${{ github.repository_owner }}/${{ env.DOCKER_IMAGE_NAME }}:${{ github.sha }} # 이미지 태그 (커밋 SHA 사용)
          # 또는 tags: ${{ env.DOCKER_REGISTRY }}/${{ github.repository_owner }}/${{ env.DOCKER_IMAGE_NAME }}:latest # latest 태그 사용
          cache-from: type=gha # GitHub Actions 캐시 사용
          cache-to: type=gha,mode=max # GitHub Actions 캐시 저장

  # 3. 배포 (CD - Deployment)
  deploy:
    needs: build-and-test # build-and-test job이 성공적으로 완료된 후에만 실행
    runs-on: ubuntu-latest # 배포를 실행할 가상 환경

    environment: production # 배포 환경 지정 (GitHub 환경 보호 규칙 적용 가능)

    steps:
      - name: Deploy to EC2 instance via SSH # SSH를 통해 EC2 인스턴스에 배포
        uses: appleboy/ssh-action@v1.0.0
        with:
          host: ${{ secrets.EC2_HOST }} # EC2 인스턴스 IP 주소 (GitHub Secret)
          username: ${{ secrets.EC2_USERNAME }} # EC2 사용자 이름 (예: ubuntu)
          key: ${{ secrets.EC2_SSH_KEY }} # EC2 SSH 프라이빗 키 (GitHub Secret)
          script: | # 서버에서 실행할 스크립트
            # 1. Docker Hub에서 최신 이미지 풀
            # 태그는 build-and-test job에서 사용한 커밋 SHA 또는 latest를 사용
            sudo docker pull ${{ env.DOCKER_REGISTRY }}/${{ github.repository_owner }}/${{ env.DOCKER_IMAGE_NAME }}:${{ github.sha }}

            # 2. 기존 컨테이너 중지 및 삭제 (선택 사항: 롤링 업데이트 시에는 다른 전략 사용)
            if [ "$(sudo docker ps -q -f name=my-nestjs-container)" ]; then
              sudo docker stop my-nestjs-container
              sudo docker rm my-nestjs-container
            fi

            # 3. 새로운 컨테이너 실행
            # 운영 환경 변수를 -e 옵션으로 전달하거나, 환경 변수 파일(예: .env.production)을 서버에 준비
            sudo docker run -d -p 3000:3000 \
              --name my-nestjs-container \
              -e DATABASE_HOST=${{ secrets.PROD_DB_HOST }} \
              -e DATABASE_USER=${{ secrets.PROD_DB_USER }} \
              -e DATABASE_PASSWORD=${{ secrets.PROD_DB_PASSWORD }} \
              -e DATABASE_NAME=${{ secrets.PROD_DB_NAME }} \
              -e JWT_SECRET=${{ secrets.PROD_JWT_SECRET }} \
              ${{ env.DOCKER_REGISTRY }}/${{ github.repository_owner }}/${{ env.DOCKER_IMAGE_NAME }}:${{ github.sha }}

            echo "Deployment successful!"