Skip to content

Deployment

Deployment. 이 페이지는 Commander 아키텍처 구성 요소를 설명합니다. monorepo 구조에 맞춘 한국어 운영 문서이며, 코드 블록은 영어 그대로입니다.

제품 지표: 25 프로바이더 · 5 토폴로지 · 18 tools · 6700+ 테스트.

CLI monorepo: npx tsx packages/core/src/cliEntry.ts · 빌드 후: commander

참고 표

FeatureSetting
CPU/Memory limits2 CPU / 4GB API, 0.5 CPU / 256MB web
LoggingJSON-file driver, 10MB max, 3 rotated files
Restart policyalways (auto-restart)
Health checks30s interval, 10s timeout, 5 retries
Rate limitingConfigurable per-tenant window/max
Multi-tenancyOptional TENANT_PROVIDER=simple with static config

주요 내용

Local (Docker Compose)

운영 시 Local (Docker Compose) 는 품질 게이트·DLQ·서킷 브레이커와 함께 씁니다. 소스는 monorepo, 전체 명세는 영문 레퍼런스를 보세요.

Production (VM / VPS)

운영 시 Production (VM / VPS) 는 품질 게이트·DLQ·서킷 브레이커와 함께 씁니다. 소스는 monorepo, 전체 명세는 영문 레퍼런스를 보세요.

Observability Stack

운영 시 Observability Stack 는 품질 게이트·DLQ·서킷 브레이커와 함께 씁니다. 소스는 monorepo, 전체 명세는 영문 레퍼런스를 보세요.

Configuration Reference

운영 시 Configuration Reference 는 품질 게이트·DLQ·서킷 브레이커와 함께 씁니다. 소스는 monorepo, 전체 명세는 영문 레퍼런스를 보세요.

예제 (코드는 영어 유지)

bash
export COMMANDER_API_KEY="your-secret-key"
export OPENAI_API_KEY="sk-..."
docker compose up -d
# API:     http://localhost:4000
# Web GUI: http://localhost:3000   (Docker / Nginx)
# Dev GUI: http://localhost:5173   (pnpm gui, no Docker)
bash
# 1. Configure environment
cp .env.example .env.production
# Edit .env.production with your API keys and settings

# 2. Deploy to any Linux VM with Docker
./scripts/deploy-vm.sh your-vm-ip --env-file .env.production
bash
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build

운영

bash
npx tsx packages/core/src/cliEntry.ts doctor
npx tsx packages/core/src/cliEntry.ts status
curl -s http://localhost:4000/health/detailed || true

관련

MIT — 멀티 에이전트 오케스트레이션을 위해.