# 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