클러스터 상세

클러스터 목록에서 클러스터를 클릭하면 상세 페이지로 이동합니다. 상태 확인, 접속, 업그레이드, 노드 풀 관리 등 클러스터와 관련된 모든 작업이 이 페이지에서 이루어집니다.

---

상단 정보

페이지 상단에서 클러스터의 핵심 상태를 한눈에 확인합니다.

항목	설명
상태	running, provisioning, upgrading, degraded 등 현재 상태
Kubernetes 버전	클러스터가 실행 중인 K8s 버전
노드 수	Ready 상태 노드 수 / 전체 노드 수
파드 수	현재 실행 중인 파드 수
생성일	클러스터가 생성된 시각

---

주요 버튼

연결 (Connect)

연결 버튼을 클릭하면 브라우저 내에 웹 터미널이 열립니다.

• 로컬에 kubectl이나 kubeconfig 설치 없이 클러스터에 바로 접속합니다.
• 일반적인 kubectl 명령을 모두 실행할 수 있습니다.
• 파드 내부 접속(kubectl exec -it)도 지원합니다.
• 클러스터가 running 또는 degraded 상태일 때만 활성화됩니다.

웹 터미널 사용법은 웹 터미널을 참고하세요.

kubeconfig 다운로드

kubeconfig 다운로드 버튼을 클릭하면 {클러스터명}-kubeconfig.yaml 파일이 다운로드됩니다.

로컬 kubectl, Lens, k9s, Helm 등 표준 Kubernetes 도구와 함께 사용할 수 있습니다.

export KUBECONFIG=~/Downloads/my-cluster-kubeconfig.yaml
kubectl get nodes
kubectl get pods -A

kubeconfig 파일에는 클러스터 접근 자격증명이 포함됩니다. Git에 커밋하거나 공유하지 마세요.

업그레이드

업그레이드 버튼을 클릭하면 Kubernetes 버전 업그레이드 설정 창이 열립니다.

• 현재 버전에서 바로 다음 마이너 버전으로만 업그레이드 가능합니다 (예: v1.35 → v1.36).
• Rolling 방식으로 서비스 중단 없이 업그레이드됩니다.
• 클러스터가 running 상태일 때만 활성화됩니다.

자세한 내용은 버전 업그레이드를 참고하세요.

삭제

삭제 버튼으로 클러스터를 영구 삭제합니다. 삭제된 클러스터는 복구할 수 없습니다. 자세한 내용은 클러스터 삭제를 참고하세요.

---

노드 풀 목록

하단에서 클러스터에 포함된 노드 풀 목록을 확인합니다. 각 노드 풀의 이름, 노드 수, CPU/메모리 사양, 상태를 확인할 수 있으며, 노드 풀 단위로 스케일 · 리사이즈 · 삭제 작업을 수행할 수 있습니다.

자세한 내용은 노드 풀 관리를 참고하세요.

---

노드 목록

클러스터에 속한 개별 워커 노드의 상태, IP, 리소스 사용률을 확인합니다.

---

이벤트

클러스터 레벨 Kubernetes 이벤트(Warning, Normal)를 시간순으로 확인합니다. 파드 스케줄링 실패, 노드 이상 등의 문제를 빠르게 파악하는 데 유용합니다.

# kubectl로 이벤트 확인
kubectl get events -A --sort-by='.lastTimestamp'
kubectl get events -A --field-selector type=Warning

---

Operations

클러스터에서 진행 중이거나 완료된 비동기 작업(생성, 업그레이드, 스케일 등)의 상세 로그를 확인합니다. Operations에서 전체 작업 이력을 볼 수 있습니다.