OPERATING DOCUMENT / CLUSTERDECK

ClusterDeck 개요

변하는 VM·Kubernetes 환경을 Profile 중심으로 연결하는 macOS workstation access layer.

01 / Context02 / Procedure03 / Operations04 / Verification

ClusterDeck 개요

ClusterDeck은 자주 재생성되는 VM과 Kubernetes 환경의 접속 경로를 안정화하는 macOS 중심 데스크톱 도구입니다.

핵심 사용 단위는 IP가 아니라 Profile입니다. Profile은 환경의 이름, host 집합, SSH 접근 경로, bastion 여부, remote kubeconfig 위치와 local context를 묶습니다.

Architecture diagram
Responsive vector rendering · source preserved
Environment Profile Hosts SSH / ProxyJump Remote kubeconfig Kubernetes verification

ClusterDeck은 Kubernetes 리소스 관리 콘솔이 아닙니다. 사용자가 kubectl, 기존 운영 UI, 개발 도구를 사용할 수 있도록 연결 가능한 상태까지 만드는 것이 제품 경계입니다.

MVP 경계

  • Profile CRUD
  • host discovery 및 SSH connectivity probe
  • 선택적 public-key bootstrap
  • SSH alias / ProxyJump
  • remote kubeconfig fetch 및 normalize
  • Profile별 local kubeconfig
  • kubectl get nodes 기반 connectivity verification

Cross-platform 및 provider-specific discovery는 core macOS workflow 안정화 이후 단계입니다.

DOCUMENT TRACE

프로젝트 상세로 돌아가면 아키텍처, 개발 흐름, 검증 근거와 관련 Field Note를 하나의 맥락에서 볼 수 있습니다.