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:
38
CLAUDE.md
38
CLAUDE.md
@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user