사전 요구 사항
GenD 플랫폼 설치 전 확인해야 할 필수 도구와 시스템 요구 사항입니다.
개요
GenD는 Kubernetes 기반으로 운영되므로 컨테이너 런타임과 클러스터 관리 도구가 필수입니다. 로컬 개발과 프로덕션 환경의 요구 사항이 다릅니다.
필수 도구
| 도구 | 최소 버전 | 용도 |
|---|---|---|
| Docker Desktop | 4.25+ | 컨테이너 런타임 |
| kubectl | 1.28+ | K8s 클러스터 관리 |
| Helm | 3.13+ | 차트 배포 |
| Kind | 0.20+ | 로컬 K8s 클러스터 |
| Python | 3.12+ | API 서버 및 시드 스크립트 |
| Node.js | 20+ | UI 빌드 |
| pnpm | 8+ | UI 패키지 관리 |
시스템 요구 사항 (로컬 개발)
- CPU: 8코어 이상 (Apple Silicon M1+ 호환)
- 메모리: 16GB RAM (Docker에 12GB 이상 할당)
- 디스크: 50GB 이상 여유 공간
- OS: macOS 13+, Ubuntu 22.04+, Windows 11 (WSL2)
ARM64 호환성
Apple Silicon 환경에서는 모든 컨테이너 이미지가 linux/arm64를 지원해야 합니다. GenD Dockerfile은 ARM64 호환으로 작성되어 있으며, USER 1000 (numeric UID)으로 K8s runAsNonRoot 정책과 호환됩니다.
네트워크 포트 요구 사항
Kind 클러스터가 호스트에 매핑하는 포트입니다. 사용 중이 아닌지 확인하세요.
| 포트 | 서비스 | 포트 | 서비스 |
|---|---|---|---|
| 31080 | Trino UI | 31443 | ArgoCD |
| 31300 | Grafana | 31500 | Harbor |
| 31800 | Keycloak | 31900 | Vault |
| 30950/30951 | Kyuubi Thrift/REST | — | — |
gend-api · gend-ui · Dagster · Kafka UI 는 NodePort 없이 ingress(
gend.local:8443)로 접근합니다.
설치 확인
docker --version && kubectl version --client && helm version --short
kind --version && python3 --version && node --version && pnpm --version