Big Bang - 100-hours-a-week/9-team-Devths-WIKI GitHub Wiki

#!/bin/bash

# ==============================================================================
# [Devths] 무중단 배포 스크립트 (Rollback 기능 포함)
# 아키텍처: Spring Boot (Blue/Green) + Next.js + FastAPI
# 수정일: 2026-01-07
# ==============================================================================

# ------------------------------------------------------------------------------
# 0. 환경 변수 설정
# ------------------------------------------------------------------------------
PROJECT_ROOT="/home/ubuntu/devths"
BACKEND_DIR="$PROJECT_ROOT/backend"
FRONTEND_DIR="$PROJECT_ROOT/frontend"
AI_DIR="$PROJECT_ROOT/ai"

NGINX_INC="/home/ubuntu/nginx/backend_url.inc"

# 백업을 저장할 임시 디렉토리
BACKUP_DIR="/home/ubuntu/deployment_backups/$(date +%Y%m%d_%H%M%S)"
mkdir -p $BACKUP_DIR

# 로그 색상 설정
TXT_GREEN='\033[0;32m'
TXT_RED='\033[0;31m'
TXT_YELLOW='\033[1;33m'
TXT_RESET='\033[0m'

function log_info() { echo -e "${TXT_GREEN}[INFO] $1${TXT_RESET}"; }
function log_warn() { echo -e "${TXT_YELLOW}[WARN] $1${TXT_RESET}"; }
function log_err()  { echo -e "${TXT_RED}[ERROR] $1${TXT_RESET}"; }

# ------------------------------------------------------------------------------
# [핵심] 롤백(Rollback) 함수 정의
# 에러 발생 시(trap) 이 함수가 호출됨
# ------------------------------------------------------------------------------
function rollback() {
  log_err "배포 중 오류가 발생했습니다! 롤백을 시작합니다..."
  
  # 1. 롤백 중 에러가 나도 멈추지 않도록 설정 변경
  set +e

  # 2. 소스코드 롤백 (Git)
  if [ -n "$PREV_COMMIT_SHA" ]; then
    log_warn "git reset --hard $PREV_COMMIT_SHA 실행 중..."
    cd $PROJECT_ROOT
    git reset --hard $PREV_COMMIT_SHA
  fi

  # 3. 백엔드 아티팩트(JAR) 복구
  if [ -f "$BACKUP_DIR/app.jar" ]; then
    log_warn "이전 app.jar 복구 중..."
    cp "$BACKUP_DIR/app.jar" "$BACKEND_DIR/build/libs/app.jar"
  fi

  # 4. 프론트엔드 빌드(.next) 복구
  if [ -d "$BACKUP_DIR/.next" ]; then
    log_warn "이전 .next 폴더 복구 중..."
    rm -rf "$FRONTEND_DIR/.next"
    cp -r "$BACKUP_DIR/.next" "$FRONTEND_DIR/.next"
  fi

  # 5. Nginx 설정 원복 (포트가 변경되었다면)
  # CURRENT_PORT는 배포 시작 전의 포트임
  if [ -n "$CURRENT_PORT" ]; then
    log_warn "Nginx 설정을 이전 포트($CURRENT_PORT)로 되돌립니다..."
    echo "set \$service_url http://127.0.0.1:$CURRENT_PORT;" > $NGINX_INC
    sudo nginx -s reload
  fi

  # 6. 새로 떴던 프로세스(NEW_PID)가 있다면 사살
  if [ -n "$NEW_PID" ]; then
    log_warn "실패한 신규 프로세스(PID: $NEW_PID) 종료 중..."
    kill -9 $NEW_PID 2>/dev/null
  fi

  # 7. 서비스 재시작 (복구된 파일 기반)
  log_warn "이전 버전으로 서비스 재시작..."
  cd $FRONTEND_DIR && pm2 reload frontend
  sudo systemctl reload ai-worker
  
  # 기존 백엔드는 종료되지 않았으므로(Blue/Green의 장점) 
  # 포트만 안 바뀌었다면 그대로 살아있음.

  log_err "롤백이 완료되었습니다. 로그를 확인해주세요."
  exit 1
}

# 스크립트 실행 중 에러(ERR) 발생 시 rollback 함수 호출
trap 'rollback' ERR
set -e

# ==============================================================================
# [Step 1] 사전 점검 및 상태 백업 (Backup)
# ==============================================================================
log_info "[Step 1] 현재 상태 백업 및 사전 점검..."

# 1. 현재 Git 커밋 해시 저장 (롤백용)
cd $PROJECT_ROOT
PREV_COMMIT_SHA=$(git rev-parse HEAD)
log_info "현재 커밋 해시 저장: $PREV_COMMIT_SHA"

# 2. 현재 실행 중인 아티팩트 백업
# (빌드 실패나 런타임 에러 시 되돌리기 위함)
log_info "현재 빌드 파일들을 백업합니다... ($BACKUP_DIR)"

# Backend Jar 백업
if [ -f "$BACKEND_DIR/build/libs/app.jar" ]; then
  cp "$BACKEND_DIR/build/libs/app.jar" "$BACKUP_DIR/app.jar"
fi

# Frontend Build 백업
if [ -d "$FRONTEND_DIR/.next" ]; then
  cp -r "$FRONTEND_DIR/.next" "$BACKUP_DIR/.next"
fi

# 3. 현재 포트 확인 (Blue/Green 판단용)
CURRENT_PORT=$(grep -oP '127.0.0.1:\K\d+' $NGINX_INC) || CURRENT_PORT="8080"
log_info "현재 활성 포트: $CURRENT_PORT"

# ==============================================================================
# [Step 2] 코드 최신화 (Git Pull)
# ==============================================================================
log_info "[Step 2] 최신 코드를 가져옵니다 (Git Pull)..."
cd $PROJECT_ROOT
git pull origin main

# ==============================================================================
# [Step 3] 백엔드 빌드 (Spring Boot)
# ==============================================================================
log_info "[Step 3] 백엔드 빌드 시작..."
cd $BACKEND_DIR
chmod +x gradlew
./gradlew clean build -x test

# ==============================================================================
# [Step 4] 프론트엔드 빌드 (Next.js)
# ==============================================================================
log_info "[Step 4] 프론트엔드 빌드 시작..."
cd $FRONTEND_DIR
npm install --production=false
npm run build

# ==============================================================================
# [Step 5] AI 서버 준비 (FastAPI)
# ==============================================================================
log_info "[Step 5] AI 서버 패키지 설치..."
cd $AI_DIR
if [ ! -d "venv" ]; then python3 -m venv venv; fi
source venv/bin/activate
pip install -r requirements.txt

# ==============================================================================
# [Step 6] 백엔드 무중단 배포 (Blue/Green)
# ==============================================================================
log_info "[Step 6] 백엔드 포트 스위칭 시작..."

# 1. 새로운 포트 결정
if [ "$CURRENT_PORT" == "8080" ]; then
  NEW_PORT=8081
else
  NEW_PORT=8080
fi
log_info "새로 띄울 포트: $NEW_PORT"

# 2. 포트 정리
TARGET_PID=$(lsof -ti :$NEW_PORT || true)
if [ -n "$TARGET_PID" ]; then kill -9 $TARGET_PID; fi

# 3. 새 서버 실행
# nohup 실행 시 set -e 때문에 종료되지 않도록 주의 필요하나, 백그라운드(&)는 영향 적음
nohup java -Xms2048m -Xmx2048m \
  -Dserver.port=$NEW_PORT \
  -Dserver.tomcat.threads.max=150 \
  -jar $BACKEND_DIR/build/libs/app.jar > /dev/null 2>&1 &

NEW_PID=$!
log_info "새 서버($NEW_PORT) 부팅 중... (PID: $NEW_PID)"

# 4. 헬스 체크
log_info "헬스 체크 진행 중..."
HEALTH_SUCCESS=false
for i in {1..12}; do
  sleep 5
  RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:$NEW_PORT/health)
  
  if [ "$RESPONSE" == "200" ]; then
    log_info "헬스 체크 통과 (HTTP 200)"
    HEALTH_SUCCESS=true
    break
  fi
  log_warn "대기 중... ($i/12)"
done

if [ "$HEALTH_SUCCESS" = false ]; then
  log_err "새 서버 헬스 체크 실패. 롤백을 트리거합니다."
  # 여기서 false를 반환하여 trap이 걸리게 함
  false
fi

# 5. Nginx 트래픽 전환
echo "set \$service_url http://127.0.0.1:$NEW_PORT;" > $NGINX_INC
sudo nginx -s reload
log_info "Nginx 트래픽 전환 완료 ($CURRENT_PORT -> $NEW_PORT)"

# ==============================================================================
# [Step 7] 프론트/AI 재시작
# ==============================================================================
log_info "[Step 7] 프론트엔드 및 AI 서버 반영..."
cd $FRONTEND_DIR
pm2 reload frontend || pm2 start npm --name "frontend" -- start
sudo systemctl reload ai-worker

# ==============================================================================
# [Step 8] 리소스 정리
# ==============================================================================
log_info "[Step 8] 구버전 서버 정리..."
OLD_PID=$(lsof -ti :$CURRENT_PORT || true)
if [ -n "$OLD_PID" ]; then
  kill -15 $OLD_PID
  log_info "구버전 서버($CURRENT_PORT) 종료 완료."
fi

# 성공 시 백업 파일 삭제 (공간 확보)
rm -rf $BACKUP_DIR
log_info "[Success] 배포 성공! 백업 파일을 정리했습니다."

#!/bin/bash

# ==========================================
# 설정 변수
# ==========================================
APP_NAME="my-web-service"
BASE_DIR="/home/user/app"
RELEASES_DIR="$BASE_DIR/releases"
LINK_PATH="$BASE_DIR/current"
# ==========================================

# 1. 현재 연결된 버전 확인 (readlink)
CURRENT_VERSION=$(readlink -f "$LINK_PATH")
echo "현재 배포된 버전: $(basename "$CURRENT_VERSION")"

# 2. 이전 버전 찾기 (현재 버전을 제외한 가장 최신 버전)
# (grep -v: 현재 버전 제외, head -n 1: 그 다음 최신)
PREVIOUS_VERSION=$(ls -td "$RELEASES_DIR"/*/ | grep -v "$CURRENT_VERSION" | head -n 1)

if [ -z "$PREVIOUS_VERSION" ]; then
    echo "[Error] 돌아갈 이전 버전을 찾을 수 없습니다."
    exit 1
fi

echo "롤백 타겟 버전: $(basename "$PREVIOUS_VERSION")"

# 3. 심볼릭 링크 교체 (핵심: -nfs 옵션으로 원자적 교체)
echo "SWITCHING symlink..."
ln -nfs "$PREVIOUS_VERSION" "$LINK_PATH"

# 4. 서비스 재시작
echo "RESTARTING service..."
sudo systemctl restart $APP_NAME

echo "롤백 완료! 현재 버전은 $(basename "$PREVIOUS_VERSION") 입니다."