Kubernetes Dashboard에서 Headlamp로 옮겨가는 이유

Kubernetes Dashboard에서 Headlamp로 옮기는 일은 화면만 바꾸는 작업이 아니야. Dashboard는 클러스터 안에서 실행되고 서비스 계정 토큰으로 들어가는 웹 앱이고, Headlamp는 데스크톱에서 사용자의 kubeconfig를 읽거나 클러스터 안에 설치해 쓸 수 있어. 처음부터 접근 모델이 다르지.¹

로그인부터 달라져

데스크톱 Headlamp는 kubectl이 쓰는 kubeconfig를 따라가. 그래서 한 앱에서 여러 클러스터를 오갈 수 있고, 별도 토큰을 붙여 넣는 로그인 흐름을 관리하지 않아도 돼. 클러스터 안에 Headlamp를 설치하면 ServiceAccount와 Kubernetes RBAC를 사용해 공유 화면을 만들 수 있어.¹

그렇다고 권한이 넓어지는 건 아니야. Headlamp는 Kubernetes API가 허용한 동작만 보여줘. 편집이나 삭제 권한이 없으면 그 동작도 제공하지 않아. Dashboard에서 높은 권한의 서비스 계정 토큰을 썼다면, 옮긴 뒤 그 권한을 줄이거나 없애는 검토가 필요해.¹

폼 대신 YAML을 다루게 돼

Dashboard에선 이미지, 복제본 수, 서비스 유형 같은 값을 폼에 넣어 앱을 만들었어. Headlamp에선 클러스터와 네임스페이스를 고른 다음 YAML 매니페스트를 붙여 넣거나 올리고, 검토한 뒤 적용해.¹

이 변화는 Headlamp가 배포 도구가 되겠다는 뜻은 아니야. 매니페스트는 Git에 두고 CI/CD·Helm·GitOps로 적용하던 흐름을 그대로 가져갈 수 있어. Headlamp는 그 결과가 클러스터에서 어떻게 움직이는지 보고, 살피고, 디버깅하는 화면에 가까워.¹

대신 화면에서 얻는 손잡이는 늘어나. Workloads·Network·Storage·Configuration 같은 영역에서 리소스를 찾고, 상태·이벤트·라벨·어노테이션·전체 YAML을 볼 수 있어. Deployment, ReplicaSet, Pod, Service가 어떻게 이어지는지는 Map View에서 한 번에 확인할 수 있고.¹

어디에 설치할까?

혼자 여러 클러스터를 다룬다면 데스크톱 방식이 간단해. 클러스터 안에 서비스를 배포하지 않고, 포트 포워딩 없이 사용자의 kubeconfig와 RBAC를 그대로 쓰거든. 팀이 함께 접속할 안정적인 URL이 필요하면 클러스터 안에 설치하는 쪽을 고르면 돼. 이 경우 Helm이나 YAML로 배포하고 Ingress와 OIDC/SSO를 함께 구성할 수 있어.¹

클러스터 안 방식은 웹 앱 하나를 더 노출하는 일이기도 해. 공식 가이드는 TLS를 쓰고 접근 가능한 네트워크를 제한하라고 해. OIDC를 붙일 때는 공개 URL 뒤에 /oidc-callback을 허용하고, Ingress가 X-Forwarded-Proto를 전달하는지도 확인해야 로그인 리디렉션이 깨지지 않아.¹

Dashboard는 바로 지우지 않아

전환 전에 현재 쓰는 클러스터와 네임스페이스, 자주 하는 작업, Dashboard 접속 방식, 서비스 계정과 RBAC 바인딩을 적어둬. 데스크톱을 고르면 kubectl config current-context와 노드 또는 접근 가능한 네임스페이스의 Pod 조회가 먼저야. Headlamp가 같은 신원과 권한을 읽는지 확인하는 기준이 되거든.¹

공식 가이드가 권하는 순서는 병행 전환이야. Headlamp를 먼저 설치하고 팀이 써보는 동안 Dashboard를 잠시 남겨둔 다음, 리소스 탐색·YAML 배포·로그·이벤트·필요한 Exec가 역할별 권한에서 작동하는지 확인해. 메트릭을 보려면 클러스터에 metrics-server도 있어야 해.¹

확인이 끝난 뒤에야 Dashboard를 제거해. Helm으로 설치했다면 Helm으로, 매니페스트나 애드온으로 설치했다면 같은 방식으로 지운 뒤 관련 Pod가 사라졌는지 확인하는 식이야. Dashboard 전용 ServiceAccount와 RoleBinding·ClusterRoleBinding, 예전 URL과 포트 포워딩 안내까지 정리해야 오래된 접근 경로가 남지 않아.¹

결국 Headlamp로의 이동은 Kubernetes 권한 모델을 바꾸는 일이 아니야. 토큰을 건네는 특정 화면에서, 각자의 kubeconfig와 매니페스트를 따라가는 화면으로 작업의 기준점을 옮기는 일이야. 전환의 완료 여부도 새 UI가 떴는지가 아니라, 같은 권한으로 필요한 작업을 재현하고 낡은 접근 경로를 닫았는지로 확인하게 돼.¹

각주

1. Kubernetes, 「Kubernetes Dashboard to Headlamp: A Step-by-Step Guide」(2026-07-13) 공식 블로그 ↩︎ ↩︎² ↩︎³ ↩︎⁴ ↩︎⁵ ↩︎⁶ ↩︎⁷ ↩︎⁸ ↩︎⁹ ↩︎¹⁰ ↩︎¹¹ ↩︎¹²