project/Ollama + CrewAI + FastAPI를 활용한 한국 주식 분석
Ollama + CrewAI + FastAPI를 활용한 한국 주식 분석 블로그 - 프로젝트 실행 및 배포 방법
octo54
2025. 3. 7. 17:21
반응형
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 응답 속도를 개선하고, 주식 분석 데이터를 최적화하는 방법을 다룹니다.