EchoShotX AI Server

EchoShotX 플랫폼의 비디오 처리 워커 서버. AWS SQS 큐 통합을 통해 AI 기반 영상 처리 작업을 수행합니다.

소개

EchoShotX AI Server는 Spring 백엔드로부터 영상 처리 요청을 받아 처리하는 멀티프로세싱 기반 워커 시스템입니다. AI 기반 업스케일링, 자막 임베딩, 음원 추출 등의 작업을 수행하고 완료 시 Spring 서버에 알립니다.

주요 기능

• Real-ESRGAN 모델을 활용한 AI 기반 영상 업스케일링
• 동시 작업 처리를 위한 멀티프로세싱 워커 풀
• 지수 백오프 기반 자동 재시도 메커니즘
• AWS SQS 기반 작업 큐 관리
• S3 기반 영상 파일 처리
• 작업 완료 시 HTTP 콜백 시스템
• 베이스 이미지 분리 배포로 빠른 빌드 (2시간 → 10-15분)

시스템 아키텍처

클라이언트
  │
  └──> Spring 서버 (Presigned URL 발급)
         │
         ├──> S3 (클라이언트 직접 업로드)
         │
         └──> SQS (작업 메시지 삽입)
                │
                └──> AI 서버
                       │
                       ├──> S3 (입력 영상 다운로드)
                       ├──> 영상 처리
                       ├──> S3 (결과 업로드)
                       │
                       └──> Spring 서버 (HTTP 콜백)
                              │
                              └──> 클라이언트 (WebSocket 알림)

배포

베이스 이미지 빌드 (초기 설정, 한 번만)

베이스 이미지는 OpenCV CUDA 빌드가 포함된 이미지로, OpenCV 업데이트 시에만 재빌드하면 됩니다.

# EC2 GPU 인스턴스에서 실행
./scripts/build-base-image.sh

자세한 배포 가이드는 docs/deployment/deployment-plan.md를 참조하세요.