쿠버네티스 Metric Server 설치 및 확인 방법

Metric Server는 쿠버네티스 클러스터의 자원 사용량(CPU, 메모리 등)을 수집해주는 필수적인 구성 요소 중 하나입니다. HPA(Horizontal Pod Autoscaler)나 kubectl top 명령어를 사용하려면 Metric Server가 설치되어 있어야 합니다. 하지만 기본적으로 쿠버네티스 클러스터에는 Metric Server가 포함되어 있지 않습니다. 이 문서에서는 Metric Server 설치 여부를 확인하는 방법과 설치하는 방법에 대해 설명합니다.

 

설치 여부 확인

Metric Server가 클러스터에 설치되어 있는지 확인하려면 다음 명령어를 실행합니다

쿠버네티스 클러스터의 각 노드에 대한 실시간 자원을 보여주는 명령어입니다.

kubectl top nodes

 

결과 -  Metric Server가 없는 경우

에러 메시지가 출력됩니다.

# 없는 경우
➜  ~ kubectl top nodes
error: Metrics API not available

 

결과 -  Metric Server가 있는 경우

노드별 CPU 및 메모리 사용량이 출력됩니다.

➜  ~ kubectl top nodes 
NAME              CPU(cores)   CPU%   MEMORY(bytes)   MEMORY%
master01          1336m        1%     14239Mi         4%
master02          643m         0%     11968Mi         3%
master03          1038m        1%     15291Mi         4%
worker01          9922m        13%    143220Mi        50%
worker02          7647m        10%    112015Mi        39%

 

설치방법

Yaml 파일로 설치하기

쿠버네티스 버전 1.21 이상

kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/high-availability-1.21+.yaml

 

쿠버네티스 버전 19~21 

kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/high-availability.yaml

 

Helm차트로 설치하기

차트 레포 등록하기

helm repo add metrics-server https://kubernetes-sigs.github.io/metrics-server/
helm repo update

 

설치하기

helm upgrade --install metrics-server metrics-server/metrics-server