From b756c9a6161a78b480a11a8aa80a4132c9ed9879 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Tue, 29 Jul 2025 19:06:56 +0900 Subject: [PATCH] =?UTF-8?q?docs:=2051124=20=EC=84=9C=EB=B2=84=EB=A1=9C=20?= =?UTF-8?q?=EC=84=9C=EB=B9=84=EC=8A=A4=20=EC=9D=B4=EC=A0=84=EC=97=90=20?= =?UTF-8?q?=EB=94=B0=EB=A5=B8=20=EB=AC=B8=EC=84=9C=20=EC=97=85=EB=8D=B0?= =?UTF-8?q?=EC=9D=B4=ED=8A=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - server-architecture.md: - skill-email, skill-news를 51124 서버로 이동 - ChromaDB 추가 - 51123 서버는 로그 저장(/mnt/hdd/logs/) 역할 명시 - log-api-guide.md: - skill-news 서비스 추가 - 서비스 위치 정보 업데이트 - emergency-manual.md: - skill 서비스 재시작 방법 추가 - 로그 정리 경로 명시 51124 서버로 모든 로빙 및 스킬 서비스 이전 반영 --- docs/architecture/emergency-manual.md | 19 ++++++++++++++++--- docs/architecture/server-architecture.md | 23 +++++++++++++++-------- docs/guide/log-api-guide.md | 5 +++-- 3 files changed, 34 insertions(+), 13 deletions(-) diff --git a/docs/architecture/emergency-manual.md b/docs/architecture/emergency-manual.md index 404d620..0174f35 100644 --- a/docs/architecture/emergency-manual.md +++ b/docs/architecture/emergency-manual.md @@ -4,19 +4,32 @@ ### 1. 서비스 다운 -#### rb 서비스가 응답하지 않을 때 +#### rb/skill 서비스가 응답하지 않을 때 ```bash # 1. 51124 서버 상태 확인 ssh -p 51124 admin@192.168.219.52 # 2. 컨테이너 상태 확인 -docker ps | grep rb +docker ps | grep -E "(rb|skill)" # 3. 컨테이너 재시작 docker restart [container_name] +# 또는 완전 재구동 +cd /home/admin/ivada_project/[project] +docker compose down +docker compose up -d --build # 4. 로그 확인 docker logs [container_name] --tail 100 + +# 5. 스킬 서비스별 재시작 +# skill-email +cd /home/admin/ivada_project/skill_email +docker compose down && docker compose up -d --build + +# skill-news +cd /home/admin/ivada_project/skill_news +docker compose down && docker compose up -d --build ``` #### nginx 502 Bad Gateway @@ -58,7 +71,7 @@ df -h # 2. Docker 정리 (주의: 실행 중인 컨테이너 확인 필수) docker system prune -af -# 3. 로그 정리 +# 3. 로그 정리 (51123 서버) sudo rm -rf /var/log/nginx/*.gz find /mnt/hdd/logs -name "*.log" -mtime +30 -delete ``` diff --git a/docs/architecture/server-architecture.md b/docs/architecture/server-architecture.md index cbb11b7..799bdc9 100644 --- a/docs/architecture/server-architecture.md +++ b/docs/architecture/server-architecture.md @@ -3,21 +3,21 @@ ## 서버 구성 ### 51123 서버 (192.168.219.45) -**역할**: 프록시, CI/CD, 인증 +**역할**: 프록시, CI/CD, 관리, 로그 저장 ``` ┌─────────────────────────────────────────────────────────┐ │ 51123 서버 │ │ │ │ ┌─────────────┐ ┌──────────────┐ ┌───────────────┐ │ -│ │ nginx │ │ Gitea │ │ skill-email │ │ -│ │ (80/443) │ │ (3000) │ │ (8501) │ │ +│ │ nginx │ │ Gitea │ │frontend-base │ │ +│ │ (80/443) │ │ (3000) │ │ (8000) │ │ │ └─────┬───────┘ └──────┬───────┘ └───────────────┘ │ │ │ │ │ -│ │ ┌───────┴──────┐ │ -│ │ │ Actions │ │ -│ │ │ Runner │ │ -│ │ └──────────────┘ │ +│ │ ┌───────┴──────┐ ┌──────────────┐ │ +│ │ │ Actions │ │ Log Storage │ │ +│ │ │ Runner │ │/mnt/hdd/logs │ │ +│ │ └──────────────┘ └──────────────┘ │ └────────┼────────────────────────────────────────────────┘ │ │ 프록시 @@ -31,6 +31,11 @@ │ │ (8001) │ │ (10508) │ │ (10408) │ │ │ └────────────┘ └────────────┘ └────────────────┘ │ │ │ +│ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ │ +│ │ skill-email │ │ skill-news │ │ ChromaDB │ │ +│ │ (8501) │ │ (8505) │ │ (8000) │ │ +│ └─────────────┘ └─────────────┘ └──────────────┘ │ +│ │ │ ┌────────────────────────────────────────────────┐ │ │ │ PostgreSQL Database │ │ │ │ (5432) │ │ @@ -46,7 +51,6 @@ | nginx | 80/443 | ro-being.com | 리버스 프록시 | | Gitea | 3000 | git.ro-being.com | Git 저장소 | | frontend-base | 8000 | /admin/* | 관리자 대시보드 | -| skill-email | 8501 | /skill-email/* | 이메일 스킬 | ### 51124 서버 | 서비스 | 포트 | nginx 경로 | 용도 | @@ -54,6 +58,9 @@ | rb8001 | 8001 | /rb8001/* | 메인 로빙 서비스 | | rb10508 | 10508 | /rb10508/* | 로빙 테스트 | | rb10408 | 10408 | /rb10408/* | 로빙 서비스 | +| skill-email | 8501 | /skill-email/* | 이메일 스킬 | +| skill-news | 8505 | /skill-news/* | 뉴스 스킬 | +| ChromaDB | 8000 | - | 벡터 데이터베이스 | ## 배포 플로우 diff --git a/docs/guide/log-api-guide.md b/docs/guide/log-api-guide.md index 70fd3ed..3a3c144 100644 --- a/docs/guide/log-api-guide.md +++ b/docs/guide/log-api-guide.md @@ -42,8 +42,9 @@ curl -H "Authorization: Bearer $TOKEN" \ - `rb10508_test` - 로빙 테스트 서비스 (51124 서버) - `rb8001` - 로빙 메인 서비스 (51124 서버) - `rb10408` - 로빙 서비스 (51124 서버) -- `skill-email` - 이메일 스킬 서비스 (51123 서버) -- `frontend-base` - 관리자 대시보드 +- `skill-email` - 이메일 스킬 서비스 (51124 서버) +- `skill-news` - 뉴스 스킬 서비스 (51124 서버) +- `frontend-base` - 관리자 대시보드 (51123 서버) ## 응답 형식 ```json