ClusterDeck

프로젝트 소개

ClusterDeck은 자주 재생성되는 VM 및 Kubernetes 환경에 대한 로컬 접속 경로를 안정적으로 유지하기 위한 macOS 중심 데스크톱 도구입니다.

일반적인 Kubernetes 관리자 콘솔이 아니라, 원격 환경을 발견하고 접속 가능한 상태로 만드는 workstation access layer에 집중합니다. 사용자는 매번 달라지는 IP를 기억하는 대신 Profile 이름을 유지하고, ClusterDeck이 SSH와 kubeconfig 경계를 정리합니다.

IP / Host Discovery
      ↓
SSH Connectivity
      ↓
SSH Bootstrap (optional)
      ↓
SSH Alias / ProxyJump
      ↓
Remote kubeconfig Fetch
      ↓
kubeconfig Normalization
      ↓
Local Profile
      ↓
Kubernetes Connectivity Check

핵심 설계

Tauri 2 + Rust: SSH orchestration, filesystem, process execution, kubeconfig 처리 등 로컬 시스템 작업의 보안 경계를 backend에 둡니다.
React + TypeScript: Profile, Host, Connect, Status 중심의 간결한 데스크톱 UI를 제공합니다.
Native OpenSSH 우선: 자체 SSH stack을 다시 구현하지 않고 ssh, scp, ssh-copy-id, ProxyJump 같은 검증된 동작을 활용합니다.
Profile 중심 모델: IP 주소보다 사람에게 안정적인 environment identity를 유지합니다.
ClusterDeck-owned config: 사용자 전체 ~/.ssh/config를 덮어쓰지 않고 ~/.clusterdeck/ 아래의 생성 파일만 소유합니다.

보안 경계

초기 비밀번호는 bootstrap용으로만 사용하고 저장하거나 로그에 남기지 않는 것을 원칙으로 합니다. 생성 kubeconfig는 제한된 파일 권한을 사용하고, 사용자 관리 SSH/Kubernetes 설정을 파괴적으로 덮어쓰지 않습니다. 지속 저장이 필요한 credential은 macOS Keychain 같은 안전한 로컬 secret store를 사용하는 방향입니다.

MVP 범위

Profile CRUD
Multi-host discovery와 SSH bootstrap
SSH alias 생성
Bastion / ProxyJump
Remote kubeconfig fetch 및 normalization
Profile별 kubeconfig 저장
Kubernetes connectivity verification
최소 클릭 중심 macOS UI

Cross-platform 지원과 provider-specific discovery는 core workflow 안정화 이후 범위입니다.

개발

pnpm install
pnpm tauri dev
 
pnpm build
cargo check --manifest-path src-tauri/Cargo.toml

상세 문서

주제	문서	내용
Overview	개요	문제 정의, 범위, Profile 중심 모델
Architecture	아키텍처	Tauri/Rust, SSH, kubeconfig 경계
Getting Started	시작하기	개발 환경과 기본 연결 흐름

프로젝트 관계

Local VM / Kubernetes labs
        ↓
    ClusterDeck
        ↓
SSH / Bastion / kubeconfig access
        ↓
Narwhal · Beluga · test clusters

기능보다 먼저 경계와 연결을 봅니다.

계속 발전하는 과정도 evidence입니다.

코드 밖에 남은 엔지니어링 지식