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