쿠버네티스 대쉬보드 설치하기

 

쿠버네티스 대시보드 설치 가이드

1. 환경 준비

• 쿠버네티스 클러스터가 정상적으로 실행 중이어야 합니다.
• kubectl 명령어가 작동하는 상태여야 합니다.

2. 대시보드 설치

아래 명령어를 실행하여 대시보드를 설치합니다:

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml
    

3. 대시보드 확인

대시보드 설치 후, 아래 명령어로 Pod 상태를 확인합니다:

kubectl get pods -n kubernetes-dashboard
    

모든 Pod의 상태가 Running이어야 합니다.

4. 대시보드에 접근

아래 명령어로 대시보드 서비스의 NodePort를 확인합니다:

kubectl get svc -n kubernetes-dashboard
    

출력 예시:

NAME                        TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)        AGE
kubernetes-dashboard        NodePort    10.96.0.1              443:32421/TCP  5m
    

• 위 출력에서 NodePort 값을 확인합니다(예: 32421).
• 브라우저에서 https://<NodeIP>:<NodePort>로 접속합니다.

5. 로그인 토큰 생성

아래 명령어로 관리자를 위한 Service Account와 Role Binding을 생성합니다:

kubectl create serviceaccount admin-user -n kubernetes-dashboard
kubectl create clusterrolebinding admin-user-binding \
  --clusterrole=cluster-admin \
  --serviceaccount=kubernetes-dashboard:admin-user
    

토큰을 가져옵니다:

kubectl -n kubernetes-dashboard get secret \
  $(kubectl -n kubernetes-dashboard get sa/admin-user -o jsonpath="{.secrets[0].name}") \
  -o go-template="{{.data.token | base64decode}}"
    

출력된 토큰을 복사하여 대시보드 로그인 화면에 붙여넣습니다.

6. 문제 해결

• Pod가 Pending 상태일 경우:
  • 네트워크 플러그인이 설치되었는지 확인합니다(flannel 설치 필요).
  • 명령어:

    kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
                        

• NodePort로 접근이 불가능한 경우, 방화벽 설정을 확인합니다.

이제 쿠버네티스 대시보드에 성공적으로 접속할 수 있습니다!