From 1033e30674dec9a59e953cb39e2b2d0a1d3968c7 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Thu, 2 Oct 2025 18:29:29 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=ED=97=AC=EC=8A=A4=EC=B2=B4=ED=81=AC=20?= =?UTF-8?q?=ED=91=9C=EC=A4=80=ED=99=94=20=EA=B4=80=EB=A0=A8=20=EC=98=A4?= =?UTF-8?q?=EB=A5=98=20=EC=A0=95=EB=B3=B4=20=EC=A0=9C=EA=B1=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 250811_Gateway필드변환문제.md: "nginx/k8s 표준" 표현 제거 - 250811_ChromaDB메모리손실.md: "k8s/nginx 표준" 표현 제거 - 250812_함수형전환및포트변경.md: "k8s/nginx 표준 준수" 제거 - 250815_개발작업.md: "/healthz 통일" 언급 제거 - Docker Compose 환경에서 /healthz는 표준 아님 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../250811_happybell80_ChromaDB메모리손실.md | 6 ++---- .../250811_happybell80_Gateway필드변환문제.md | 4 +--- .../250812_happybell80_함수형전환및포트변경.md | 5 ++--- troubleshooting/250815_happybell80_개발작업.md | 1 - 4 files changed, 5 insertions(+), 11 deletions(-) diff --git a/troubleshooting/250811_happybell80_ChromaDB메모리손실.md b/troubleshooting/250811_happybell80_ChromaDB메모리손실.md index f4a0c65..2ff8955 100644 --- a/troubleshooting/250811_happybell80_ChromaDB메모리손실.md +++ b/troubleshooting/250811_happybell80_ChromaDB메모리손실.md @@ -112,9 +112,7 @@ async def get_robeing_info(username: str): - 특히 경로, 디렉토리명, 헬스체크 변경 시 - Docker Compose와 Actions의 볼륨 경로 일치 확인 -### 2. **헬스체크 표준화** -- `/healthz` 사용 (k8s/nginx 표준) -- 모든 서비스 통일 +### 2. **헬스체크 구현** - 빠른 응답 우선 ### 3. **환경변수 빌드 체크** @@ -136,7 +134,7 @@ async def get_robeing_info(username: str): ### 해결됨 ✅ - ChromaDB 디렉토리 통일 (`chroma_db`) -- 헬스체크 `/healthz` 표준화 +- 헬스체크 엔드포인트 추가 - Frontend 환경변수 설정 - Gateway username 지원 diff --git a/troubleshooting/250811_happybell80_Gateway필드변환문제.md b/troubleshooting/250811_happybell80_Gateway필드변환문제.md index 6879413..95d671f 100644 --- a/troubleshooting/250811_happybell80_Gateway필드변환문제.md +++ b/troubleshooting/250811_happybell80_Gateway필드변환문제.md @@ -2,11 +2,10 @@ ## 오전 10:58 -### 문제 1: 헬스체크 엔드포인트 표준화 +### 문제 1: 헬스체크 엔드포인트 추가 **상황**: - 각 서비스마다 다른 헬스체크 엔드포인트 -- nginx/k8s 표준인 `/healthz` 필요 **해결**: ```python @@ -90,7 +89,6 @@ fetch('/gateway/api/chat', { ## 교훈 ### 1. **헬스체크 설계** -- 표준 엔드포인트 사용 (`/healthz`) - 빠른 응답 우선 (복잡한 체크는 별도 엔드포인트) - 루트 레벨 배치로 프리픽스 문제 회피 diff --git a/troubleshooting/250812_happybell80_함수형전환및포트변경.md b/troubleshooting/250812_happybell80_함수형전환및포트변경.md index dba84b9..1e2c174 100644 --- a/troubleshooting/250812_happybell80_함수형전환및포트변경.md +++ b/troubleshooting/250812_happybell80_함수형전환및포트변경.md @@ -55,10 +55,9 @@ BASIC_EMOTIONS = settings.BASIC_EMOTIONS.split(',') 5. **README.md**: 문서 업데이트 6. **http_embedding_function.py**: 기본 URL -#### 헬스체크 표준화 (/healthz) +#### 헬스체크 구현 - 단순 헬스체크: `/healthz` (서비스 생존 확인) - 상세 헬스체크: `/health` (모델 정보 포함) -- k8s/nginx 표준 준수 ## 오후 2시 50분 @@ -116,7 +115,7 @@ curl http://localhost:8515/healthz 2. **skill-embedding 포트 변경** - 8015 → 8515 완료 - - /healthz 표준화 + - /healthz 엔드포인트 추가 - docker-compose.yml 개선 #### 실수와 교훈 diff --git a/troubleshooting/250815_happybell80_개발작업.md b/troubleshooting/250815_happybell80_개발작업.md index 9a95dcf..56a3fc2 100644 --- a/troubleshooting/250815_happybell80_개발작업.md +++ b/troubleshooting/250815_happybell80_개발작업.md @@ -63,7 +63,6 @@ settings.MISTRAL_MODEL ``` #### 추가 수정 -- 모든 헬스체크 경로를 `/healthz`로 통일 - README.md 업데이트 #### 교훈