Headlamp

어떤 사용자를 위한 프로그램인가

Headlamp는 Kubernetes를 운영하는 개발자, 플랫폼 엔지니어, 클러스터 상태를 확인하는 팀원을 위한 관리 화면입니다. Kubernetes SIG UI에 속한 공식 하위 프로젝트이며 특정 클라우드 사업자에 종속되지 않는 UI를 지향합니다.

로컬 데스크톱 앱은 사용자의 kubeconfig로 클러스터에 연결합니다. 클러스터 안에 배포하면 팀원이 브라우저로 접속하는 형태로 사용할 수 있습니다. 클러스터와 접근 자격 증명은 별도로 준비해야 하며, 앱 설치만으로 Kubernetes 환경이 만들어지지는 않습니다.

리소스 조회와 운영 기능

리소스 목록과 상세 화면을 살펴보면서 Pod 로그를 읽고 컨테이너 안에서 명령을 실행할 수 있습니다. 리소스 편집기도 제공하지만 변경 가능 범위는 접속 계정의 권한에 따릅니다.

0.45.0은 Service 상세 화면에서 선택자가 가리키는 Pod를 보여 주며, 노드의 Cordoned·Drained 상태도 표시합니다. StatefulSet과 영구 볼륨 요청인 PVC 생성 폼은 YAML을 처음부터 작성하는 부담을 줄입니다. 생성 결과의 의미와 운영 환경에 미칠 영향은 사용자가 확인해야 합니다.

macOS 설치와 첫 작업 순서

공식 macOS 안내는 Homebrew의 brew install --cask headlamp 또는 GitHub Releases의 DMG 설치를 설명합니다. DMG 방식은 Mac에 맞는 ARM64 또는 x64 파일을 받아 열고 앱을 Applications 폴더로 옮기는 순서입니다. 직접 내려받은 앱은 새 버전을 다시 설치해야 하며 자동 업그레이드는 제공하지 않는다고 안내합니다.

첫 작업은 접근 가능한 클러스터의 kubeconfig를 준비하고 앱을 실행한 뒤, 대상 클러스터와 네임스페이스를 확인하는 것입니다. 기본 경로 외의 파일은 실행 인수나 KUBECONFIG 환경 변수로 지정할 수 있습니다. 처음에는 리소스 조회와 로그 확인부터 진행하는 편이 좋습니다.

실무 예시: 배포 후 서비스가 응답하지 않을 때

예를 들어 테스트 환경에 배포한 웹 서비스가 응답하지 않으면 먼저 올바른 클러스터와 네임스페이스를 선택합니다. Service 상세 화면에서 연결 대상으로 표시되는 Pod를 확인하고, 예상한 Pod가 없으면 Service 선택자와 Pod 라벨을 비교합니다.

대상 Pod가 있다면 상태와 로그를 확인해 애플리케이션 기동 실패 여부를 좁힙니다. 대기 중인 Pod는 Resource Map의 Unscheduled 그룹에서도 찾을 수 있습니다. 이 흐름은 화면에 나타난 정보를 바탕으로 원인을 조사하는 예시이며, 문제를 자동으로 복구해 준다는 뜻은 아닙니다.

무료 이용과 확장 기능의 조건

공식 FAQ는 Headlamp를 Apache 2.0 라이선스로 제공하는 무료 오픈소스 프로젝트로 설명하며 상업적 이용도 허용합니다. 확인한 자료에는 별도 유료판이나 무료판의 클러스터 수 제한이 제시되지 않았습니다.

플러그인은 기능별 선행 조건을 확인해야 합니다. 예를 들어 Flux 플러그인은 클러스터에 Flux가 필요합니다. Catalog의 Official·Verified 표시는 출처나 게시자 확인에 도움을 주지만 보안 감사를 의미하지는 않습니다. 연동 서비스의 이용 조건은 Headlamp 자체의 무료 제공과 별도로 검토해야 합니다.

문제가 생겼을 때 확인할 순서

클러스터가 보이지 않으면 kubeconfig 경로와 선택한 컨텍스트, 인증 정보, API 서버 연결 상태부터 확인합니다. Access Denied가 반복되면 계정의 RBAC 권한을 확인하고, 특정 네임스페이스만 허용된 계정은 클러스터 설정에 접근 가능한 네임스페이스를 지정합니다. 편집·삭제 버튼이 없는 경우도 권한에 따른 정상 동작일 수 있습니다.

CPU·메모리 사용량이 보이지 않으면 클러스터의 Metrics Server 설치 여부를 확인합니다. 플러그인 화면이 작동하지 않으면 해당 플러그인의 의존 구성 요소를 먼저 살펴봅니다.

선택 기준과 배포 상태 검토

리소스와 로그를 시각적으로 탐색하고 여러 클러스터를 오가거나 팀용 UI를 확장하려면 Headlamp를 검토할 수 있습니다. 명령을 반복 실행하거나 작업을 스크립트로 재현하려는 경우에는 Kubernetes 명령줄 도구인 kubectl을 함께 사용하는 구성이 적합합니다. 이는 작업 방식에 따른 선택 기준입니다.

2026-10-09 확인한 공식 배포 목록은 0.45.0을 Latest로 표시했습니다. 지원 종료 프로그램이라는 공지는 확인되지 않았습니다. 다만 배포 안내에는 Mac·Windows의 서명 관련 경고 링크가 있고, 데스크톱 문서는 Windows 미서명 상태를 명시하므로 운영체제 경고와 해당 릴리스 안내를 검토해야 합니다.

공식 안내

• Headlamp 공식 홈페이지 · 확인 2026-10-09
• Headlamp 공식 저장소 README · 확인 2026-10-09
• Desktop App · 확인 2026-10-09
• Mac OS Installation · 확인 2026-10-09
• Release 0.45.0 · 확인 2026-10-09
• Frequently Asked Questions · 확인 2026-10-09
• Plugins Desktop Installation · 확인 2026-10-09
• Kubernetes Metrics Server · 확인 2026-10-09
• Command line tool (kubectl) · 확인 2026-10-09