Docker Compose와 Nginx로 단독 VPS에서 Blue-Green 무중단 배포 구성하는 실전 가이드

mkdir -p /opt/myapp/{nginx,blue,green,scripts}
cd /opt/myapp

# /opt/myapp/blue/docker-compose.yml
version: "3.8"

services:
  app:
    image: myregistry/myapp:${APP_VERSION:-latest}
    container_name: myapp-blue
    restart: unless-stopped
    ports:
      - "8001:3000"  # blue는 8001 포트
    environment:
      - NODE_ENV=production
      - DATABASE_URL=${DATABASE_URL}
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 15s

# /opt/myapp/green/docker-compose.yml
version: "3.8"

services:
  app:
    image: myregistry/myapp:${APP_VERSION:-latest}
    container_name: myapp-green
    restart: unless-stopped
    ports:
      - "8002:3000"  # green은 8002 포트
    environment:
      - NODE_ENV=production
      - DATABASE_URL=${DATABASE_URL}
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 15s

# /opt/myapp/nginx/conf.d/upstream.conf
# 이 파일만 교체해서 트래픽 방향을 바꿔요

upstream myapp_backend {
    server 127.0.0.1:8001;  # blue 활성 상태
}

server {
    listen 80;
    server_name myapp.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name myapp.example.com;

    ssl_certificate /etc/letsencrypt/live/myapp.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/myapp.example.com/privkey.pem;

    location / {
        proxy_pass http://myapp_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }

    location /health {
        access_log off;
        proxy_pass http://myapp_backend;
    }
}

#!/bin/bash
# /opt/myapp/scripts/deploy.sh
# 사용법: ./deploy.sh v1.2.3

set -e  # 에러 나면 즉시 중단

APP_VERSION=${1:?"버전을 인자로 넘겨주세요. 예: ./deploy.sh v1.2.3"}
NGINX_CONF_DIR="/opt/myapp/nginx/conf.d"
BLUE_DIR="/opt/myapp/blue"
GREEN_DIR="/opt/myapp/green"

# 현재 어떤 환경이 살아있는지 확인
CURRENT_PORT=$(grep -oP '(?<=server 127.0.0.1:)\d+' $NGINX_CONF_DIR/upstream.conf)

if [ "$CURRENT_PORT" = "8001" ]; then
    ACTIVE="blue"
    STANDBY="green"
    STANDBY_DIR=$GREEN_DIR
    STANDBY_PORT=8002
else
    ACTIVE="green"
    STANDBY="blue"
    STANDBY_DIR=$BLUE_DIR
    STANDBY_PORT=8001
fi

echo "현재 활성: $ACTIVE (포트 $CURRENT_PORT) → 새 버전 배포 대상: $STANDBY"

# 새 컨테이너 빌드 & 시작
cd $STANDBY_DIR
APP_VERSION=$APP_VERSION docker compose up -d --no-deps --build

# 헬스체크 대기 (최대 60초)
echo "헬스체크 대기 중..."
for i in $(seq 1 12); do
    sleep 5
    HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:$STANDBY_PORT/health)
    if [ "$HTTP_STATUS" = "200" ]; then
        echo "헬스체크 통과! ($i회 시도)"
        break
    fi
    echo "아직 준비 중... ($i/12)"
    if [ $i -eq 12 ]; then
        echo "헬스체크 실패. 배포를 중단해요."
        docker compose down
        exit 1
    fi
done

# Nginx upstream 교체
cat > $NGINX_CONF_DIR/upstream.conf << EOF
upstream myapp_backend {
    server 127.0.0.1:$STANDBY_PORT;
}
EOF

# Nginx 핫리로드 (기존 연결 유지!)
nginx -t && nginx -s reload
echo "Nginx 트래픽 전환 완료: $ACTIVE → $STANDBY"

# 구 컨테이너는 30초 후 종료 (기존 연결 처리 시간)
sleep 30
cd /opt/myapp/$ACTIVE
docker compose down
echo "배포 완료! 현재 활성: $STANDBY (포트 $STANDBY_PORT)"

# 실행 권한 부여
chmod +x /opt/myapp/scripts/deploy.sh

# 배포 실행
/opt/myapp/scripts/deploy.sh v1.2.3

#!/bin/bash
# /opt/myapp/scripts/rollback.sh

NGINX_CONF_DIR="/opt/myapp/nginx/conf.d"
CURRENT_PORT=$(grep -oP '(?<=server 127.0.0.1:)\d+' $NGINX_CONF_DIR/upstream.conf)

# 현재 포트의 반대로 전환
if [ "$CURRENT_PORT" = "8002" ]; then
    ROLLBACK_PORT=8001
    ROLLBACK_ENV="blue"
else
    ROLLBACK_PORT=8002
    ROLLBACK_ENV="green"
fi

# 롤백 대상 컨테이너가 떠있는지 확인
HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:$ROLLBACK_PORT/health)
if [ "$HTTP_STATUS" != "200" ]; then
    echo "롤백 대상($ROLLBACK_ENV)이 응답 없어요. 먼저 컨테이너를 올려주세요."
    exit 1
fi

cat > $NGINX_CONF_DIR/upstream.conf << EOF
upstream myapp_backend {
    server 127.0.0.1:$ROLLBACK_PORT;
}
EOF

nginx -t && nginx -s reload
echo "롤백 완료! → $ROLLBACK_ENV (포트 $ROLLBACK_PORT)"

# .github/workflows/deploy.yml
name: Deploy to VPS

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: 이미지 빌드 & 레지스트리 푸시
        run: |
          docker build -t myregistry/myapp:${{ github.sha }} .
          docker push myregistry/myapp:${{ github.sha }}

      - name: VPS에 배포
        uses: appleboy/[email protected]
        with:
          host: ${{ secrets.VPS_HOST }}
          username: deploy
          key: ${{ secrets.VPS_SSH_KEY }}
          script: |
            /opt/myapp/scripts/deploy.sh ${{ github.sha }}