dc4656e452
All checks were successful
news-summary-bot-cicd / build_push_deploy (push) Successful in 11m43s
2.0 KiB
2.0 KiB
운영 가이드
YouTube 뉴스 요약 봇의 배포 및 운영 가이드.
아키텍처: n8n (RSS 트리거) → FastAPI 앱 (Docker 컨테이너) → Claude API → Discord 웹훅
배포 절차
1. Docker 이미지 빌드 & Push
docker build -t nkey/news-summary-bot:latest .
docker push nkey/news-summary-bot:latest
2. OCI 서버 설정
docker-compose.yml과.env파일을 서버에 준비.env에 아래 값 설정:ANTHROPIC_API_KEY— Claude API 키DISCORD_WEBHOOK_URL— Discord 웹훅 URLAPI_SECRET— n8n에서 호출 시 인증용 시크릿
- 컨테이너 실행:
docker compose pull && docker compose up -d
3. 업데이트 시
# 로컬에서
docker build -t nkey/news-summary-bot:latest .
docker push nkey/news-summary-bot:latest
# OCI 서버에서
docker compose pull && docker compose up -d
헬스체크
curl http://localhost:8000/health
로그 확인
docker compose logs -f news-summary-bot
트러블슈팅
| 증상 | 원인 | 해결 |
|---|---|---|
| 자막 추출 실패 | 영상에 자막 없음 | 자동생성 자막이 없는 영상은 스킵됨 |
| Discord 전송 실패 | 웹훅 URL 만료 | Discord에서 웹훅 재생성 후 .env 업데이트 |
| 401 Unauthorized | API_SECRET 불일치 | n8n 헤더와 .env 값 확인 |
| Claude API 오류 | API 키 만료 또는 잔액 부족 | Anthropic 콘솔에서 확인 |
| Discord embed 글자 수 초과 | 요약이 4096자 초과 | summarizer.py의 max_tokens 줄이기 |
모니터링 포인트
/health엔드포인트로 컨테이너 상태 확인- Discord 채널에 요약이 정상적으로 올라오는지 확인
docker compose logs로 에러 로그 모니터링
비용 관리
- Claude Sonnet 4.6: Input $3/MTok, Output $15/MTok
- 일 1~2건 기준 월 ~$3 이내
- Anthropic 콘솔에서 usage 확인