QUICK_DEPLOY.md

빠른 배포 가이드 (요약)

1단계: DigitalOcean Droplet 생성

1. https://www.digitalocean.com/ 접속
2. Create → Droplets
3. 설정:
   • Ubuntu 22.04 LTS
   • 8GB RAM / 4 vCPUs ($48/월)
   • Singapore 또는 Seoul
4. SSH 키 또는 비밀번호 설정
5. Create Droplet

2단계: 서버 접속 및 초기 설정

# 서버 접속
ssh root@YOUR_SERVER_IP

# 시스템 업데이트 및 필수 패키지 설치
apt update && apt upgrade -y
apt install -y python3 python3-pip python3-venv git curl nginx certbot python3-certbot-nginx supervisor ufw build-essential

# 방화벽 설정
ufw allow OpenSSH
ufw allow 'Nginx Full'
ufw allow 11434/tcp
ufw enable

3단계: Ollama 설치

curl -fsSL https://ollama.com/install.sh | sh
systemctl enable ollama
ollama pull llama2  # 또는 사용할 모델

4단계: 프로젝트 배포

# 프로젝트 디렉토리 생성
mkdir -p /var/www
cd /var/www

# 프로젝트 파일 업로드 (Git 또는 SCP)
git clone YOUR_REPO_URL soy-nv-ai
# 또는
# scp -r "D:\SOY NV AI\*" root@YOUR_SERVER_IP:/var/www/soy-nv-ai/

cd soy-nv-ai

# 가상환경 설정
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

# 환경 변수 설정
nano .env
# SECRET_KEY, OLLAMA_BASE_URL, GEMINI_API_KEY 등 설정

# 디렉토리 생성
mkdir -p instance uploads vector_db knowledge_graphs logs
chmod -R 775 uploads instance vector_db

5단계: systemd 서비스 설정

# 서비스 파일 복사
cp systemd/soy-nv-ai.service /etc/systemd/system/

# 파일 수정 (경로 확인)
nano /etc/systemd/system/soy-nv-ai.service

# 서비스 활성화
systemctl daemon-reload
systemctl enable soy-nv-ai
systemctl start soy-nv-ai
systemctl status soy-nv-ai

6단계: Nginx 설정

# Nginx 설정 파일 복사
cp nginx/soy-nv-ai.conf /etc/nginx/sites-available/soy-nv-ai

# 도메인/IP 수정
nano /etc/nginx/sites-available/soy-nv-ai

# 활성화
ln -s /etc/nginx/sites-available/soy-nv-ai /etc/nginx/sites-enabled/
rm /etc/nginx/sites-enabled/default  # 선택사항

# 테스트 및 재시작
nginx -t
systemctl restart nginx

7단계: SSL 설정 (도메인 있는 경우)

certbot --nginx -d YOUR_DOMAIN.com -d www.YOUR_DOMAIN.com

8단계: 배포 스크립트 실행 (선택사항)

chmod +x deploy.sh
./deploy.sh

완료!

웹사이트 접속:

• HTTP: http://YOUR_SERVER_IP
• HTTPS: https://YOUR_DOMAIN.com (SSL 설정 후)

문제 해결

# 서비스 로그
journalctl -u soy-nv-ai -f

# Nginx 로그
tail -f /var/log/nginx/soy-nv-ai-error.log

# 서비스 재시작
systemctl restart soy-nv-ai
systemctl restart nginx

유용한 명령어

# 서비스 관리
systemctl start/stop/restart/status soy-nv-ai

# 로그 확인
journalctl -u soy-nv-ai -n 50 -f

# 프로세스 확인
ps aux | grep python
htop

# 디스크 확인
df -h