diff --git a/troubleshooting/250729_happybell80_프론트엔드재설계.md b/troubleshooting/250729_happybell80_서비스구축및배포복구.md similarity index 76% rename from troubleshooting/250729_happybell80_프론트엔드재설계.md rename to troubleshooting/250729_happybell80_서비스구축및배포복구.md index 8e68a4f..83b8b9d 100644 --- a/troubleshooting/250729_happybell80_프론트엔드재설계.md +++ b/troubleshooting/250729_happybell80_서비스구축및배포복구.md @@ -1,4 +1,4 @@ -# 프론트엔드 재설계 및 GUI 공유 아키텍처 논의 +# 프론트엔드 재설계, auth-server 구축 및 rb8001 배포 복구 **날짜**: 2025-07-29 **작업자**: happybell80 & Claude @@ -215,5 +215,67 @@ Claude가 세션 시작 시 규칙을 제대로 따르지 않음. CLAUDE.md 재 - 로빙 생태계에서 auth-server 역할 명확화 - 멀티테넌트 B2B 인증 허브로서의 정체성 확립 +## 오후 9시 45분 + +### rb8001 서비스 중지 문제 해결 + +**배경**: 24 서버팀으로부터 rb8001 서비스가 중지 상태라는 보고 접수 + +**문제 진단 과정**: + +1. **초기 진단**: + - rb8001 컨테이너 실행되지 않음 + - 8001 포트 사용 없음 + - 로그 API에서 빈 결과 반환 + +2. **코드 검토 및 수정**: + - `docker-compose.yml`: rb10508_test와 동일한 구조로 수정 + - `network_mode: host` 적용 + - `SKILL_EMAIL_URL` 환경변수 추가 + - logs 볼륨 마운트 방식 통일 + - `requirements.txt` 최적화: `sentence-transformers`, `torch` 제거 (1GB+ 절약) + - `JWT_SECRET_KEY` 실제 값으로 업데이트 + - Gitea Actions를 51124 서버 SSH 배포 방식으로 변경 + +3. **Sequential Thinking을 통한 정확한 문제 진단**: + - 초기에는 docker-compose 버전 문제로 추정 + - 실제 문제는 **LOG_LEVEL 대소문자 문제**로 판명 + - `LOG_LEVEL=INFO` (대문자) → uvicorn이 소문자 요구 + - `KeyError: 'INFO'` 오류 발생 + +**해결 작업**: + +1. **코드 수정**: + - `run.py`: `log_level=get_env("LOG_LEVEL", "info").lower()` 추가 + - `.env`: `LOG_LEVEL=INFO` → `LOG_LEVEL=info` 변경 + +2. **배포 완료**: + - git push → Gitea Actions 자동 실행 + - 51124 서버에 정상 배포 완료 + +**최종 결과**: +- ✅ rb8001 컨테이너: Up (healthy) +- ✅ uvicorn 정상 실행 +- ✅ health check: `{"status":"healthy"}` +- ✅ nginx 프록시: `https://ro-being.com/rb8001/health` 정상 응답 +- ✅ 포트 8001 정상 서비스 + +**교훈**: + +1. **Sequential Thinking의 중요성**: + - 초기 추정과 실제 문제가 다를 수 있음 + - 체계적 분석을 통해 정확한 원인 파악 필요 + +2. **환경변수 대소문자 주의**: + - uvicorn LOG_LEVEL은 소문자만 허용 + - 방어적 프로그래밍으로 `.lower()` 적용 권장 + +3. **rb10508_test와 rb8001 구조 통일**: + - 성공한 설정을 다른 서비스에 적용하는 것이 효과적 + - docker-compose.yml, requirements.txt 일관성 중요 + +4. **배포 파이프라인 검증**: + - 코드 수정 → git push → Actions → 배포 → 서비스 확인까지 전체 플로우 점검 필요 + --- -**작성 완료**: 2025-07-29 21:20 \ No newline at end of file +**작성 완료**: 2025-07-29 21:45 \ No newline at end of file