kubernetes에 공식 문서에 dashboard 설치 가이드가 존재한다.
그런 이유로 간단하게 설치하는 방법만 정리한다.

https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/

2026/02/02일 현재 kubernetes dashboard를 기존에 나온 가이드로 설치하려면 실패한다.

https://kubernetes.github.io/dashboard/ 해당 페이지는 더 이상 존재하지 않아 helm 설치가 불가능하다. 그러나 아래 workaround로 아직은 사용이 가능하다.

최근 대안으로 headlamp가 거론되고 있다.

 

kubernetes dashboard template 생성 및 배포

helm repo 주소를 https://kubernetes.github.io/dashboard/에서  https://kubernetes-retired.github.io/dashboard/를 사용하면 아직은 사용이 가능하다.

# 현재 아래 repo는 사용할 수 없다.
# helm template kubernetes-dashboard kubernetes-dashboard \
  --repo https://kubernetes.github.io/dashboard/ \
  --set kong.proxy.type=LoadBalancer \
  --set kong.proxy.http.enabled=true > kubernetes-dashboard-deploy.yaml
 
# 아래 repo는 사용이 가능한 것으로 확인된다. 
# helm template kubernetes-dashboard kubernetes-dashboard \
  --repo https://kubernetes-retired.github.io/dashboard/ \
  --set kong.proxy.type=LoadBalancer \
  --set kong.proxy.http.enabled=true > kubernetes-dashboard-deploy.yaml

# kubectl apply -f kubernetes-dashboard-deploy.yaml --server-side

kubernetes dashboard 접근 계정 생성

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin-user

---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-user
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: admin-user
  namespace: default

---
apiVersion: v1
kind: Secret
metadata:
  name: admin-user
  annotations:
    kubernetes.io/service-account.name: "admin-user"
type: kubernetes.io/service-account-token

위 파일을 배포 진행한다.

kubernetes dashboard 접근 토큰 확인

# kubectl get secret admin-user -o jsonpath={".data.token"} | base64 -d;echo
eyJhbGciOiJSUzI1NiIsImtpZCI6IjRyQTBGSWQ1dUdSY2N5NWJWQXJHbXdDaV9iMkdsSHlXQlF1Ujk3alE3SEUifQ.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJkZWZhdWx0Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZWNyZXQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoiYWRtaW4tdXNlciIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50LnVpZCI6ImU4ZDgwOTM4LWQyYTUtNDlhOC05YTNmLTQ1MzY4MWEzNzQxZiIsInN1YiI6InN5c3RlbTpzZXJ2aWNlYWNjb3VudDpkZWZhdWx0OmFkbWluLXVzZXIifQ.uvSTHphjzShKgL-vL4JXNMXUOH6yF91QxzyNqQkD6qWhmLAmk6R3Cnkvyd5iVDN6ZJtJ_-D6q3QkLtBjcKRpuRKdMVw-CuUSwSHOVyT9eZBEdLavmx98BKVQBUNTGLBQZNRr14-OdwY3Z59Tpu2_cKWzBoc896IQw16gz4t3MoVwSxYLzNHhxtKSbfKj9XiENVzErIpD9pLcopy02q0ejfNqQAauhko8J6p6bKAlyfatC3dQsfETazDZhgxpRFq_Syj1mdxj-iTU_2RZUnZfPe2h4E4jYO60W0egx7ko_z6_xo6r1bNSGs3xPmm5rQxa740b6C-9E1FVXC-Rzmv_vA

생성된 토큰은 다른 곳에서도 사용할 수 있다.

eyJhbGciOiJSUzI1NiIsImtpZCI6IjRyQTBGSWQ1dUdSY2N5NWJWQXJHbXdDaV9iMkdsSHlXQlF1Ujk3alE3SEUifQ.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJkZWZhdWx0Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZWNyZXQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoiYWRtaW4tdXNlciIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50LnVpZCI6ImU4ZDgwOTM4LWQyYTUtNDlhOC05YTNmLTQ1MzY4MWEzNzQxZiIsInN1YiI6InN5c3RlbTpzZXJ2aWNlYWNjb3VudDpkZWZhdWx0OmFkbWluLXVzZXIifQ.uvSTHphjzShKgL-vL4JXNMXUOH6yF91QxzyNqQkD6qWhmLAmk6R3Cnkvyd5iVDN6ZJtJ_-D6q3QkLtBjcKRpuRKdMVw-CuUSwSHOVyT9eZBEdLavmx98BKVQBUNTGLBQZNRr14-OdwY3Z59Tpu2_cKWzBoc896IQw16gz4t3MoVwSxYLzNHhxtKSbfKj9XiENVzErIpD9pLcopy02q0ejfNqQAauhko8J6p6bKAlyfatC3dQsfETazDZhgxpRFq_Syj1mdxj-iTU_2RZUnZfPe2h4E4jYO60W0egx7ko_z6_xo6r1bNSGs3xPmm5rQxa740b6C-9E1FVXC-Rzmv_vA