소개
KDash는 Rust로 빠르고 간단하게 만들어진 Kubernetes 터미널 대시보드입니다. Deepu K Sasidharan이 개발한 이 오픈소스 도구는 터미널 기반 인터페이스(TUI)를 통해 Kubernetes 클러스터의 리소스를 실시간으로 모니터링하고 관리할 수 있게 해줍니다. 컨테이너 로그 스트리밍, 리소스 관리 작업, 포트 포워딩 등 핵심 기능을 키보드만으로 직관적으로 사용할 수 있습니다.
상세정보
실시간 리소스 모니터링
- 클러스터의 모든 리소스(노드, 파드, 서비스, 디플로이먼트 등)를 실시간으로 관찰하고 새로고침할 수 있습니다.
- 사용자 정의 리소스 정의(CRD)도 자동으로 발견하여 탐색할 수 있습니다.
컨테이너 로그 스트리밍
- 실시간으로 컨테이너 로그를 스트리밍하며, 타임스탬프 표시(t)와 줄 바꿈(w) 토글 기능을 제공합니다.
- 워크로드에 속한 모든 파드의 로그를 하나로 합쳐서 볼 수도 있습니다.
리소스 관리 작업
- 삭제(Ctrl-d), 편집(e), 워크로드 롤아웃 재시작(r) 등 다양한 리소스 관리 작업을 수행할 수 있습니다.
- 보안을 위해 중요한 작업은 확인 프롬프트가 표시됩니다.
- Pod나 Service의 포트 포워딩(f)을 설정하고 관리할 수 있습니다.
심층 드릴다운 네비게이션
- 워크로드에서 해당 Pod로, Pod에서 Container로, Node에는 해당 Pod로 이동하며 깊이 탐색할 수 있습니다.
- 컨테이너에서 셸(s)을 열어 직접 명령을 실행할 수도 있습니다.
다운로드·설치 방법
KDash는 여러 패키지 관리자를 통해 설치할 수 있습니다. Windows 사용자에게는 Scoop 방식을 권장합니다.
Scoop을 이용한 Windows 설치 (권장)
다음 명령어를 순서대로 실행합니다.
scoop bucket add kdash-bucket https://github.com/kdash-rs/scoop-kdash
scoop install kdash
Chocolatey를 이용한 Windows 설치
다음 명령어를 실행합니다.
choco install kdash
최신 버전을 지정하려면: choco install kdash –version=2.1.1
스크립트를 이용한 직접 설치 (Windows)
PowerShell에서 다음 명령어를 실행하여 설치할 수 있습니다.
irm https://raw.githubusercontent.com/kdash-rs/kdash/main/scripts/install.ps1 | iex
사용자 PATH에 자동으로 추가하려면: & ([scriptblock]::Create((irm https://raw.githubusercontent.com/kdash-rs/kdash/main/scripts/install.ps1))) -AddToPath
기본 사용법
설치 후 터미널에서 ‘kdash’ 명령어를 입력하여 실행합니다. 메인 화면이 표시되면 ‘?’ 키를 눌러 모든 키 바인딩 목록을 확인할 수 있습니다.
주요 키 바인딩
- 이동: 화살표 키 또는 k/j로 항목 선택/스크롤, 왼쪽/오른쪽 화살표(또는 h/l)로 리소스 탭 전환
- 필터링: ‘/’ 키를 눌러 현재 보기를 필터링합니다.
- 작업: ‘m’으로 선택된 리소스의 작업 메뉴를 열고, ‘d’로 설명, ‘y’로 YAML을 봅니다.
- 테마 전환: ‘t’ 또는 ‘Alt+t’로 내장된 테마(Macchiato, Latte, Gruvbox Dark 등)를 전환합니다.
이런 경우에 유용합니다
- 쿠버네티스 클러스터의 상태를 GUI 없이 빠르게 확인하고 싶을 때.
- 서버 환경이나 원격 접속 시 리소스 모니터링과 간단한 관리 작업을 수행해야 할 때.
- 여러 클러스터의 컨텍스트를 전환하며 작업해야 할 때.
- 컨테이너 로그를 실시간으로 모니터링하고 디버깅할 때.
지원 환경·시스템 요구사항
- 운영 체제: Windows, macOS, Linux
- 아키텍처: x86_64, arm64
- 필수 조건: Kubernetes 클러스터에 연결할 수 있는有效的 kubeconfig 파일이 필요합니다.
- 선택 사항: 리소스 사용량 메트릭을 보려면 클러스터에 metrics-server가 설치되어 있어야 합니다.
최신 버전·업데이트
현재 최신 버전은 2.1.1입니다. GitHub 릴리스 페이지에서 새 버전과 변경 사항을 확인할 수 있습니다.
제한 사항·확인 사항
- Windows 환경에서는 PowerShell보다 CMD 사용 시 색상 표시가 더 잘 작동합니다.
- 로컬 클러스터(k3d)를 사용하는 경우, kube-rs와의 호환성을 위해 서버 URL을 127.0.0.1로 설정해야 합니다.
- Linux에서 클립보드 복사 기능은 일부 배포판이나 ARM 아키텍처에서 작동하지 않을 수 있습니다.
시스템 요구사항
Kubernetes 클러스터에 연결하기 위해有效的 kubeconfig 파일이 필요합니다. 리소스 사용량 메트릭을 보려면 클러스터에 metrics-server가 설치되어 있어야 합니다.


