OpenForge 문서 목차 보기
/oss/clusterdeck/getting-started

ClusterDeck 시작하기

macOS 개발 환경 준비와 Profile 기반 SSH·kubeconfig 연결 흐름.

ClusterDeck 시작하기

현재 초기 범위는 macOS 중심입니다. 개발은 Tauri 2, Rust, React, TypeScript를 사용합니다.

권장 경로는 소스 실행입니다.

pnpm install
pnpm tauri dev

또는 v0.5.0 릴리스의 macOS(Apple Silicon aarch64 또는 Intel x64) .dmg를 내려받아 바로 실행할 수 있습니다. 아직 Apple Developer ID 서명이 없어 최초 실행 시 "확인되지 않은 개발자" 경고가 뜨므로, 앱을 우클릭 후 열기로 실행해야 합니다.

기본 검증은 frontend production build와 Rust backend check를 함께 수행합니다.

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

연결 흐름

  1. 환경 이름으로 Profile을 생성합니다.
  2. CIDR 또는 명시적 주소로 host를 발견합니다.
  3. SSH connectivity를 확인합니다.
  4. 필요한 경우 public key bootstrap을 수행합니다.
  5. Bastion이 있으면 ProxyJump 경로를 구성합니다.
  6. control-plane host에서 kubeconfig를 가져옵니다.
  7. endpoint와 context를 Profile 기준으로 normalize합니다.
  8. local Profile kubeconfig로 Kubernetes API를 검증합니다.

보안 주의

실제 IP, password, private key, kubeconfig, bearer token, certificate를 공개 문서·이슈·스크린샷에 포함하지 않습니다. bootstrap password는 일회성 입력으로 취급하고 저장·로그 출력을 피합니다.