Ollama + CrewAI + FastAPI를 활용한 한국 주식 분석 블로그

5. 프로젝트 실행 및 배포 방법

이 글에서는 FastAPI 기반으로 구축된 한국 주식 분석 블로그를 실제 운영 환경에 배포하는 방법을 다룹니다.
✅ 로컬 환경에서 프로젝트 실행
✅ Docker를 활용한 FastAPI 배포
✅ AWS/GCP/VPS를 활용한 서버 배포
✅ 배포 후 API 및 블로그 확인

5.1 로컬 환경에서 프로젝트 실행

배포하기 전에 로컬 환경에서 프로젝트가 정상적으로 실행되는지 확인해야 합니다.

5.1.1 Conda 환경 활성화

conda activate stock_analysis

5.1.2 CrewAI 리포트 생성

python src/stock_analysis/main.py

5.1.3 FastAPI 실행

uvicorn src.stock_analysis.api:app --host 127.0.0.1 --port 8000 --reload

5.1.4 웹 브라우저에서 확인

1️⃣ http://127.0.0.1:8000/ → 웹 UI에서 리포트 확인
2️⃣ http://127.0.0.1:8000/report/ → JSON 형식으로 리포트 API 확인

5.2 Docker를 활용한 FastAPI 배포

Docker를 활용하면 개발 환경과 배포 환경을 일치시키고, 컨테이너 단위로 쉽게 배포할 수 있습니다.

5.2.1 Dockerfile 작성

아래 내용을 Dockerfile로 저장합니다.

# Python 3.12 기반 이미지 사용
FROM python:3.12

# 작업 디렉토리 설정
WORKDIR /app

# 필요한 패키지 복사 및 설치
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 프로젝트 코드 복사
COPY src /app/src

# FastAPI 서버 실행
CMD ["uvicorn", "src.stock_analysis.api:app", "--host", "0.0.0.0", "--port", "8000"]

5.2.2 requirements.txt 생성

pip freeze > requirements.txt

5.2.3 Docker 이미지 빌드 및 실행

# Docker 이미지 빌드
docker build -t stock_analysis .

# Docker 컨테이너 실행
docker run -d -p 8000:8000 --name stock_analysis_container stock_analysis

5.2.4 Docker 컨테이너 확인

docker ps  # 실행 중인 컨테이너 확인

5.3 클라우드 서버(AWS/GCP/VPS) 배포

FastAPI 프로젝트를 AWS, GCP, 또는 개인 VPS에 배포하는 방법을 설명합니다.

5.3.1 서버 환경 준비 (Ubuntu 기준)

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip
pip install fastapi uvicorn

5.3.2 서버에서 프로젝트 실행

uvicorn src.stock_analysis.api:app --host 0.0.0.0 --port 8000

5.3.3 방화벽 설정 (AWS EC2 기준)

AWS 보안 그룹에서 포트 8000을 열어 웹 접근 허용합니다.

5.3.4 도메인 연결 (선택 사항)

도메인을 활용하여 stock-analysis.com과 같은 주소에서 블로그를 운영할 수 있습니다.

5.4 배포 후 API 및 블로그 확인

5.4.1 배포된 서버 확인

웹 블로그: http://your-server-ip:8000/
리포트 API: http://your-server-ip:8000/report/

5.4.2 API 자동 실행 설정

# 서버 재부팅 시 FastAPI 자동 실행
nohup uvicorn src.stock_analysis.api:app --host 0.0.0.0 --port 8000 &

📌 정리 및 다음 단계

이제 FastAPI 기반 한국 주식 분석 블로그를 서버에 배포하여 사용자들이 접근할 수 있도록 설정했습니다.

✅ 로컬 환경에서 프로젝트 실행 확인
✅ Docker 컨테이너로 FastAPI 배포
✅ AWS/GCP/VPS를 활용한 서버 배포
✅ API 및 블로그 정상 작동 확인

🔜 다음 글 예고: 6. 프로젝트 성능 최적화 및 유지보수

다음 글에서는 API 응답 속도를 개선하고, 주식 분석 데이터를 최적화하는 방법을 다룹니다.