Skip to content

README.md

Latest commit

 

History

History
53 lines (38 loc) · 2.4 KB

README.md

File metadata and controls

53 lines (38 loc) · 2.4 KB
Raw

DocGrid Backend

Local DB

로컬 개발 DB는 Docker Compose로 실행합니다. 기본 이미지는 PostgreSQL 17과 pgvector 0.8.1을 함께 제공하는 pgvector/pgvector:0.8.1-pg17입니다.

cp .env.example .env
docker compose pull postgres
docker compose up -d --wait --wait-timeout 60 postgres
docker compose ps postgres
./gradlew bootRun --args='--spring.profiles.active=local'

docker compose up --wait가 PostgreSQL의 healthy 상태를 확인한 뒤에만 Application을 기동한다.

DB 기본 접속 정보는 localhost:55432, database app, user app입니다. 로컬 기본 DB_SSLMODE는 disable이며 실제 비밀번호와 운영 접속정보는 환경변수로 주입합니다.

PostgreSQL 17은 docgrid_postgres17_data 전용 볼륨을 사용합니다. 기존 PostgreSQL 14 opensql_data 볼륨을 재사용하거나 자동 삭제하지 않습니다.

자세한 내용은 docs/local-db.md를 참고하세요.

임베딩 서버

문서 청크/질의를 벡터로 변환하는 FastAPI + sentence-transformers 서버입니다. 이미지가 자체 빌드 대상이라 최초 1회 build가 필요합니다.

docker compose build embedding-server
docker compose up -d embedding-server
  • 첫 실행 시 BAAI/bge-m3 모델 다운로드로 약 10~15분 소요됩니다 (약 3GB).
  • docker logs -f docgrid-embedding으로 진행 상태를 확인할 수 있습니다.
  • 모델 로딩이 끝나기 전까지 GET /health는 503을 반환합니다. 200이 될 때까지 대기 후 사용하세요.
  • 기본 접속 정보는 http://localhost:8000이며, Spring Boot에서는 EMBEDDING_SERVER_URL 환경변수로 오버라이드할 수 있습니다.

Ollama (RAG LLM 서버)

RAG 답변 생성에 사용하는 로컬 LLM(qwen2.5:3b) 서버입니다. 공식 이미지를 그대로 사용하므로 별도 build 없이 실행만 하면 됩니다.

docker compose up -d ollama
docker compose exec ollama ollama pull qwen2.5:3b
docker compose exec ollama ollama run qwen2.5:3b "안녕"
  • pull은 최초 1회만 필요합니다 (약 2GB, ollama-data 볼륨에 캐시되어 이후 재구동 시 재다운로드하지 않습니다).
  • 정상 응답이 텍스트로 출력되면 준비 완료입니다.
  • 기본 접속 정보는 http://localhost:11434이며, Spring Boot에서는 OLLAMA_SERVER_URL 환경변수로 오버라이드할 수 있습니다.