OpenForge 문서 목차 보기
/oss/clusterdeck/architecture

ClusterDeck 아키텍처

Tauri UI, Rust core, OpenSSH, kubeconfig가 나뉘는 로컬 시스템 도구 아키텍처.

ClusterDeck 아키텍처

ClusterDeck은 local systems tool의 보안 민감 작업을 Rust backend에 두고, React UI는 Profile과 상태를 표현하는 구조입니다.

Architecture diagram
Responsive vector rendering · source preserved
Tauri UI (React / TypeScript) ↓ Tauri CommandsRust Application Core Profile Service Discovery Service SSH / Bastion Service Kubeconfig Service Cluster Health Service ↓OpenSSH / kubectl / local filesystem

SSH 경계

MVP는 자체 SSH client를 다시 구현하지 않고 native OpenSSH를 우선 사용합니다. ssh, scp, ssh-copy-id, ProxyJump의 기존 동작을 재사용하고 ClusterDeck은 orchestration과 결과 상태를 담당합니다.

~/.ssh/config 전체를 재작성하지 않고 다음처럼 ClusterDeck 소유 파일만 관리하는 것이 기본 모델입니다.

~/.ssh/config
  Include ~/.clusterdeck/ssh/*.conf

kubeconfig 경계

remote control-plane host에서 kubeconfig를 가져와 parse/validation 후 endpoint 및 cluster/user/context 이름을 Profile 기준으로 normalize합니다. 생성 파일은 ~/.clusterdeck/kubeconfigs/에 별도로 유지해 기존 사용자 kubeconfig를 함부로 덮어쓰지 않습니다.

신뢰 경계 (Keychain / /etc/hosts)

kubeconfig·SSH 외에 사용자 시스템을 건드리는 지점은 두 곳뿐이며 둘 다 opt-in입니다. 클러스터 내부 CA를 신뢰하면 System이 아닌 로그인 키체인에 SSL/TLS 신뢰 정책 범위로만 추가되고, /etc/hosts는 Profile별 opt-in일 때만 # >>> ClusterDeck BEGIN (profile: <id>) >>> 마커로 감싼 자기 블록에 한해 admin 프롬프트로 씁니다.

검증

최소 상태는 SSH, kubeconfig, Kubernetes API를 구분해 보여줍니다.

SSH             ✓
Kubeconfig      ✓
Kubernetes API  ✓