ae9598f8ab
- docs/troubleshooting/ → troubleshooting/ - DOCS 루트 레벨에 위치하도록 변경 - README.md 링크 경로도 함께 수정
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# ChromaDB 캐시 권한 문제 해결
|
|
|
|
**날짜**: 2025-07-08
|
|
**작업자**: happybell80 & Claude
|
|
|
|
## 시간 미상
|
|
|
|
### ChromaDB 캐시 권한 문제
|
|
|
|
**문제**:
|
|
- Permission denied 에러로 임베딩 모델 캐시 실패
|
|
|
|
**원인**:
|
|
- `/opt/models` 디렉터리 권한 부족
|
|
|
|
**해결**:
|
|
1. 호스트에서 모델 사전 다운로드
|
|
2. 컨테이너에 적절한 권한 설정
|
|
3. `sudo chown -R 999:999` 권한 조정
|
|
|
|
**커밋**: `506918d`, `19ab06c`
|
|
|
|
## 주요 해결 패턴 정리
|
|
|
|
### Docker 관련
|
|
- **권한 문제**: `chown -R 999:999` (컨테이너 사용자 권한)
|
|
- **빌드 최적화**: 의존성 분리, 캐시 활용
|
|
- **볼륨 마운트**: 데이터 영속성과 권한 관리
|
|
|
|
### 배포 최적화
|
|
- **타이밍 이슈**: 충분한 대기 시간 또는 조건부 확인
|
|
- **환경변수**: 파일 보존으로 재생성 비용 절약
|
|
- **명령어 최적화**: 여러 단계를 하나로 통합
|
|
|
|
### Slack API 제약
|
|
- **3초 타임아웃**: 즉시 응답 + 백그라운드 처리 패턴
|
|
- **중복 이벤트**: 타임아웃 재시도 방지 로직
|
|
- **롤백 전략**: 환경변수 토글로 기능 전환
|
|
|
|
### ChromaDB 및 AI 모델
|
|
- **다국어 지원**: multilingual 모델 선택
|
|
- **캐시 관리**: 사전 다운로드 + 적절한 권한
|
|
- **메모리 최적화**: 검색 개수와 품질의 균형 |