Headlamp

범용 Kubernetes UI

• 특정 벤더에 종속되지 않는 일반 목적 Kubernetes 대시보드입니다.
• 리소스 목록 조회와 상세 확인 기능을 기본으로 제공합니다.

유연한 실행 방식

• 클러스터 내부(in-cluster) 배포 형태로 동작합니다.
• 로컬 kubeconfig를 사용하는 데스크톱 앱으로도 실행할 수 있습니다.

멀티 클러스터 및 플러그인 확장

• 여러 Kubernetes 클러스터를 동시에 관리할 수 있습니다.
• headlamp-k8s/plugins 저장소의 플러그인을 통해 기능을 확장할 수 있으며, Artifact Hub에서도 공개 플러그인을 검색할 수 있습니다.

권한 기반 UI 제어

• RBAC 권한에 따라 삭제·갱신 등 액션이 비활성화됩니다.
• 리소스 생성·갱신·삭제 작업을 도중 취소할 수 있습니다.
• 로그 확인, 컨테이너 exec, 문서화된 리소스 편집기를 제공합니다.

설치 및 기본 사용

Windows 환경에서는 MSI 설치 패키지를 통해 데스크톱 앱을 설치할 수 있으며, winget 명령으로 간편하게 설치할 수도 있습니다.

• winget install --id Headlamp.Headlamp --exact 명령으로 설치합니다.
• 설치 후 로컬에서 사용하려면 기본 경로에 kubeconfig 파일이 미리 설정되어 있어야 Headlamp가 클러스터 정보를 읽을 수 있습니다.
• 클러스터 내부에 배포해 사용하고자 하는 경우 공식 문서의 in-cluster 설치 안내를 따릅니다.

Headlamp는 RBAC를 사용해 리소스 접근 권한을 확인합니다. 토큰 권한이 제한적인 경우 일부 클러스터 리소스가 정상적으로 표시되지 않을 수 있으므로, 필요한 경우 Service Account 토큰을 별도로 생성해 사용합니다.

지원 환경 및 요구사항

• 데스크톱 앱은 Linux, Mac, Windows용으로 제공되며, 이번 릴리스의 Windows 패키지는 x64 아키텍처의 MSI 설치 파일입니다.
• 로컬 실행 시 사용할 kubeconfig가 기본 경로에 존재해야 합니다.
• Headlamp가 동작을 검증한 Kubernetes 플랫폼 목록은 저장소의 docs/platforms.md 문서에서 관리됩니다.

확인 사항 및 라이선스

• Headlamp는 Apache 2.0 라이선스로 배포됩니다.
• 플러그인 개발과 기여 절차는 공식 문서의 플러그인 개발 가이드 및 CONTRIBUTING.md에서 안내합니다.
• 프로젝트 문의와 토론은 Kubernetes Slack의 #headlamp 채널과 월간 커뮤니티 미팅을 통해 진행됩니다.