LearnHouse Enterprise Edition에는 Kubernetes 1.25 이상용 공식 Helm 차트가 있어요. 릴리스 하나가 자체 네임스페이스에서 LearnHouse 설치 하나를 실행해요: 웹 앱, API, 협업 서버가 각각 별도의 Deployment로, 하나의 Ingress 뒤에서 동작해요. Community Edition은 대신 CLI와 Docker로 설치해요.
namespace: academy
web
Next.js
api
FastAPI
collab
Hocuspocus
ingress-nginx와 cert-manager를 설치하고, 빈 데이터베이스를 만들고, values 파일에 설정을 넣은 다음 차트를 설치하세요. 그 전에 사전 점검 스크립트가 클러스터, DNS, 발급자(issuer), 스토리지, 라이선스, 레지스트리 접근을 확인하며, 아무것도 변경하지 않아요.
helm repo add learnhouse https://partners.learnhouse.app/chartshelm repo updatehelm install academy learnhouse/learnhouse-ee -n academy --create-namespace -f academy.yaml| 구성 요소 | 수평 확장 |
|---|---|
| web | 가능해요. 상태가 없으므로 오토스케일러와 중단 예산(disruption budget)을 사용하세요. |
| api | 가능해요. S3 스토리지나 ReadWriteMany 볼륨이 필요해요. 단일 노드 볼륨에서는 레플리카 하나로 유지돼요. |
| collab | 불가능해요. 실시간 문서가 메모리에 보관되므로 레플리카를 하나로 유지하세요. |
| PostgreSQL, Redis | 차트 범위 밖이에요. 제공업체의 고가용성 옵션을 사용하세요. |
Pod는 권한 상승이 꺼지고 모든 capability가 제거된 non-root 사용자로 실행되며, 이는 Kubernetes restricted Pod Security Standard를 충족해요. 서비스 계정 토큰은 앱에 마운트되지 않아요. 선택적인 NetworkPolicy로 인바운드 트래픽을 인그레스 컨트롤러에서 오는 것으로 제한할 수 있고, 자체 시크릿 관리자를 사용할 수도 있어요.
Kubernetes가 맞는 경우
회사가 이미 클러스터를 운영하고 있을 때, 웹 앱과 API의 레플리카 여러 개를 가용 영역에 분산하고 싶을 때, 또는 LearnHouse를 기존 GitOps와 시크릿 관리 체계에 맞춰 넣어야 할 때 선택하세요.
공식 차트는 Enterprise Edition용이며, 라이선스 키로 이미지를 가져와요. Community Edition은 CLI와 Docker Compose로 설치해요.
간단히 평가해 볼 때는 차트가 PostgreSQL과 Redis를 단일 Pod로 실행할 수 있어요. 복제나 백업이 없으므로 프로덕션 설치에서는 관리형 서비스를 사용하세요.
이미지 태그를 바꾸고 helm upgrade를 실행하세요. API가 시작될 때 데이터베이스를 마이그레이션하며, 선택적인 pre-upgrade Job으로 마이그레이션을 먼저 실행할 수도 있어요. 릴리스를 넘어 업그레이드하기 전에는 데이터베이스를 백업하세요.
서버를 직접 운영하고 싶지 않나요? LearnHouse Cloud가 같은 플랫폼을 대신 운영하고, 업데이트, 백업, TLS까지 처리해 드려요.
Cloud 요금제 보기