vignette/infra/docker-compose.yml
Yun Chan 204726f707 feat(infra): 이식 가능한 Docker 배포 구성
- docker-compose.yml: web/api/db(pgvector)/rag/proxy 한 방 기동
- 엔진 어댑터 분리: ENGINE_URL/ENGINE_MODE로 로컬 claude -p ↔ API 전환(코드 무수정 이전)
- Caddy: 자동 TLS + SSE flush/WSS 무버퍼(실시간 음성)
- DEPLOYMENT.md: 이식/엔진분리/스케일업/외부노출 가이드
- 페이지 레이아웃 시안 6종(login/learner-home/session-review/professor/admin/settings)
2026-06-25 21:24:19 +09:00

100 lines
3.4 KiB
YAML

# Vignette — 이식 가능한 단일 호스트 배포 구성
# 어디서든: cp .env.example .env && (값 채우고) && docker compose up -d
#
# 설계 원칙:
# - web/api/db/voice/rag 는 전부 컨테이너 → 호스트 무관하게 한 방에 뜬다.
# - "엔진"(로컬 claude -p)만 컨테이너 밖. api 는 ENGINE_URL 로 가리킨다.
# → 옮길 때 ENGINE_URL 한 줄만 바꾸면 됨(로컬 게이트웨이 ↔ API 폴백).
# - 시크릿/엔드포인트는 전부 .env. 이미지에 굽지 않는다(이식성).
name: vignette
services:
db:
image: pgvector/pgvector:pg16
restart: unless-stopped
environment:
POSTGRES_USER: ${POSTGRES_USER:-vignette}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set in .env}
POSTGRES_DB: ${POSTGRES_DB:-vignette}
volumes:
- pgdata:/var/lib/postgresql/data
- ./db/init:/docker-entrypoint-initdb.d:ro # 스키마/확장 초기화 SQL
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-vignette}"]
interval: 10s
timeout: 5s
retries: 5
networks: [vignette]
api:
build:
context: ../apps/api
dockerfile: Dockerfile
restart: unless-stopped
depends_on:
db: { condition: service_healthy }
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-vignette}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB:-vignette}
# === 엔진(이식성 핵심) ===
# 로컬 운영: host 의 claude -p 게이트웨이를 가리킴(아래 extra_hosts 사용)
# 클라우드 이전: 이 값을 Messages API 어댑터 URL 로만 바꾸면 됨.
ENGINE_URL: ${ENGINE_URL:-http://host.docker.internal:9099}
ENGINE_MODE: ${ENGINE_MODE:-claude_p} # claude_p | messages_api
ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-} # 폴백/클라우드용
OPENAI_API_KEY: ${OPENAI_API_KEY:?set in .env} # 음성
RAG_EMBED_URL: http://rag:8080
SESSION_SECRET: ${SESSION_SECRET:?set in .env}
extra_hosts:
- "host.docker.internal:host-gateway" # 컨테이너→호스트 엔진 게이트웨이 접근(Linux 포함)
healthcheck:
test: ["CMD", "python", "-c", "import urllib.request,sys; urllib.request.urlopen('http://localhost:8000/health'); "]
interval: 15s
timeout: 5s
retries: 5
networks: [vignette]
web:
build:
context: ../apps/web
dockerfile: Dockerfile
args:
VITE_API_BASE: ${PUBLIC_API_BASE:-/api}
restart: unless-stopped
depends_on: [api]
networks: [vignette]
# RAG 사이드카: BGE-M3 임베딩 + BGE-reranker-v2-m3 (CPU 가능, GPU 있으면 가속)
rag:
build:
context: ../apps/api
dockerfile: Dockerfile.rag
restart: unless-stopped
environment:
EMBED_MODEL: BAAI/bge-m3
RERANK_MODEL: BAAI/bge-reranker-v2-m3
volumes:
- ragmodels:/models # 모델 캐시(재다운로드 방지 = 이식 시 볼륨만 옮기면 빠름)
networks: [vignette]
# 리버스프록시 + TLS. 외부노출(chanpaca.net)도 여기서. 끄려면 profiles 로 제외.
proxy:
image: caddy:2-alpine
restart: unless-stopped
depends_on: [web, api]
ports:
- "${HTTP_PORT:-8080}:80"
- "${HTTPS_PORT:-8443}:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddydata:/data
networks: [vignette]
volumes:
pgdata:
ragmodels:
caddydata:
networks:
vignette:
driver: bridge