ClusterDeck 아키텍처

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

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를 함부로 덮어쓰지 않습니다.

검증

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

SSH             ✓
Kubeconfig      ✓
Kubernetes API  ✓