docs: Add News API deployment guide and SAPIENS services

- Add comprehensive deployment guide in CLAUDE.md
  - Quick deploy commands for News API
  - Version management strategy (Major/Minor/Patch)
  - Rollback procedures
- Add detailed DEPLOYMENT.md for News API service
- Update docker-compose.yml with SAPIENS platform services
  - Add sapiens-web with PostgreSQL (port 3005, 5433)
  - Add sapiens-web2 with PostgreSQL (port 3006, 5434)
  - Configure health checks and dependencies

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jungwoo choi
2025-10-22 09:20:55 +09:00
parent 86ca214dd8
commit 07579ea9f5
3 changed files with 256 additions and 0 deletions

View File

@ -273,3 +273,41 @@ Services register themselves with Console on startup and send periodic heartbeat
- Console validates tokens and forwards to services
- Internal service communication uses service tokens
- Rate limiting at API Gateway level
## Deployment Guide
### News API Deployment
**IMPORTANT**: News API는 Kubernetes에 배포되며 Docker 이미지 버전 관리가 필요합니다.
상세 가이드: `services/news-api/DEPLOYMENT.md` 참조
#### Quick Deploy
```bash
# 1. 버전 설정
export VERSION=v1.1.0
# 2. 빌드 및 푸시 (버전 태그 + latest)
cd services/news-api
docker build -t yakenator/news-api:${VERSION} -t yakenator/news-api:latest -f backend/Dockerfile backend
docker push yakenator/news-api:${VERSION}
docker push yakenator/news-api:latest
# 3. Kubernetes 재시작
kubectl -n site11-news rollout restart deployment news-api-deployment
kubectl -n site11-news rollout status deployment news-api-deployment
```
#### Version Management
- **Major (v2.0.0)**: Breaking changes, API 스펙 변경
- **Minor (v1.1.0)**: 새 기능 추가, 하위 호환성 유지
- **Patch (v1.0.1)**: 버그 수정, 작은 개선
#### Rollback
```bash
# 이전 버전으로 롤백
kubectl -n site11-news rollout undo deployment news-api-deployment
# 특정 버전으로 롤백
kubectl -n site11-news set image deployment/news-api-deployment \
news-api=yakenator/news-api:v1.0.0
```