Kubebox

클러스터 모니터링

• kubeconfig 파일에서 자동으로 설정을 읽어옵니다 (KUBECONFIG 환경변수 또는 ~/.kube 디렉토리).
• 클러스터와 네임스페이스 수준의 이벤트를 실시간으로 확인할 수 있습니다.
• 인터랙티브하게 Kubernetes 컨텍스트를 전환할 수 있습니다.

파드 및 컨테이너 관리

• 선택한 네임스페이스의 파드 목록을 실시간으로 감시합니다.
• 컨테이너 로그를 스크롤링하거나 실시간으로 확인할 수 있습니다.
• 컨테이너에 원격 셸을 열어 명령을 실행할 수 있습니다.

리소스 사용량 차트

• 메모리, CPU, 네트워크, 파일 시스템 사용량을 시각적 차트로 모니터링합니다.
• cAdvisor DaemonSet이 배포되어 있어야 이 기능을 사용할 수 있습니다.

다운로드·설치 방법

Kubebox는 독립 실행형 실행 파일로 배포됩니다. 공식 GitHub 릴리스 페이지에서 운영 체제에 맞는 파일을 다운로드할 수 있습니다.

• Windows: curl -Lo kubebox.exe https://github.com/astefanutti/kubebox/releases/download/v0.10.0/kubebox-windows.exe
• macOS: curl -Lo kubebox https://github.com/astefanutti/kubebox/releases/download/v0.10.0/kubebox-macos && chmod +x kubebox
• Linux (x86_64): curl -Lo kubebox https://github.com/astefanutti/kubebox/releases/download/v0.10.0/kubebox-linux && chmod +x kubebox

다운로드 후 실행 파일을 직접 실행하면 됩니다. 추가 설치 과정은 필요하지 않습니다.

기본 사용법

실행 후 kubeconfig 파일이 자동으로 감지되면 로그인 화면이 표시됩니다. 컨텍스트를 선택하고 로그인하면 메인 인터페이스로 진입합니다.

주요 단축키는 다음과 같습니다:

• Enter: 항목 선택 또는 폼 제출
• Tab/Shift+Tab: 화면 내 포커스 이동
• ↑/↓: 목록, 폼, 로그 내비게이션
• Ctrl+q 또는 q: 종료 (터미널 버전)
• r: 컨테이너에 원격 셸 연결

이런 경우에 유용합니다

• Kubernetes 클러스터의 실시간 상태를 터미널에서 빠르게 확인하고 싶을 때
• 여러 컨테이너의 로그를 동시에 모니터링해야 할 때
• 컨테이너 내부에 접속하여 디버깅 작업을 수행해야 할 때
• 클러스터 이벤트를 시각적으로 추적하고 싶을 때

지원 환경·시스템 요구사항

• 지원 OS: Windows, macOS, Linux (x86_64, ARMv7)
• 실행 방식: 독립 실행형, Docker, kubectl run, 웹 브라우저
• 필수 구성요소: Kubernetes 클러스터에 대한 접근 권한 (kubeconfig 파일)

최신 버전·업데이트

현재 최신 버전은 0.10.0입니다. 릴리스 정보는 공식 GitHub 릴리스 페이지에서 확인할 수 있습니다.

제한 사항·확인 사항

• 컨테이너 리소스 사용량 차트를 보려면 cAdvisor가 DaemonSet으로 클러스터에 배포되어 있어야 합니다.
• cAdvisor REST API 프록시에는 적절한 RBAC 권한이 필요합니다.
• Web 버전에서는 OpenID Connect의 사용자 정의 IDP 인증서 파일이 지원되지 않습니다.
• Web 버전에서는 q 키로의 종료 기능을 사용할 수 없습니다.

FAQ

Q: Kubebox는 무료인가요?
A: 예, Kubebox는 MIT 라이선스로 배포되는 오픈 소스 소프트웨어입니다.

Q: Kubernetes 클러스터 없이 사용할 수 있나요?
A: 아니요, Kubebox는 Kubernetes 클러스터 관리를 위해 설계되었으므로 클러스터 접근 권한이 필요합니다.

Q: 리소스 사용량 차트가 보이지 않습니다.
A: cAdvisor를 DaemonSet으로 배포하고 RBAC 권한을 설정해야 합니다. 자세한 내용은 공식 문서의 cAdvisor 섹션을 참조하세요.