Cloud/Kubernetes
원본 글 보기

[Kubernetes] Liveness·Readiness Probe로 헬스 체크하기

[Kubernetes] Liveness·Readiness Probe로 헬스 체크하기

[Kubernetes]

Health check

4) Health check(헬스 체크)

쿠버네티스는 각 컨테이너의 상태를 주기적으로 체크해서, 문제가 있는 컨테이너를 자동으로 재시작하거나 또는 문제가 있는 컨테이너(Pod를) 서비스에서 제외할 수 있다. 이러한 기능을 헬스체크(Health check)라고 하는데, (각 노드에 상주하는 kubelet이 이를 담당한다.) 크게 두 가지 방법이 있다.

1. 활성 프로브(Liveness probe) : 프로그램이 정상적으로 실행 중인 것을 검사(컨테이너가 살아 있는지 아닌지를 체크하는 방법)

2. 준비 상태 프로브(Readiness probe) : 프로그램이 요청을 받을 준비가 되었는지를 검사(컨테이너가 서비스가 가능한 상태인지를 체크)

활성 프로브(Liveness probe), 준비 상태 프로브(Readiness probe)는 컨테이너가 정상적인지 아닌지를 체크하는 방법으로, 3가지 방식을 제공한다.

(1) 프로브 대응 핸들러

- Command probe:

컨테이너의 상태 체크를 쉘 명령을 수행하고 나서, 그 결과를 가지고 컨테이너의 정상여부를 체크한다. 쉘 명령어를 수행한 후, 결과값이 0 이면 성공, 0이 아니면 실패로 간주한다.

- ✅ HTTP probe:

httpGet : 일반적인 로드밸런스가 헬스체크를 하는 것처럼 특정 url로 get 요청을 정기적으로 수행.

가장 많이 사용하는 probe 방식으로 HTTP GET을 이용하여, 컨테이너의 상태를 체크한다.

지정된 URL로 HTTP GET 요청을 보내서 리턴되는 HTTP 응답 코드가 200~300 사이면 probe를 정상으로 판단하고, 그 이외의 값일 경우에는 비정상으로 판단한다. 아래 실습할 예제가 바로 HTTP probe를 이용한 readiness probe를 정의한 예제이다.

- TCP probe:

tcpSocket : 지정된 tcp 포트로 연결할 수 있는지 없는지 확인.

TCP probe는 지정된 포트에 TCP 연결을 시도하여, 연결이 성공하면, 컨테이너가 정상인것으로 판단한다.

💡 Liveness probe, Readiness probe 차이점?

Liveness probe는 컨테이너의 상태가 비정상이라고 판단하면, 해당 Pod를 재시작하는데 반해

Readiness probe는 컨테이너가 비정상일 경우에는 해당 Pod를 사용할 수 없음으로 표시하고, 서비스등에서 제외한다.

# Liveness Probe

Liveness probe는 컨테이너의 상태를 주기적으로 체크해서, 응답이 없으면 컨테이너를 자동으로 재시작해준다. 컨테이너가 정상적으로 기동 중인지를 체크하는 기능이다. Liveness probe는 Pod의 상태를 체크하다가, Pod의 상태가 비정상인 경우 kubelet을 통해서 재 시작한다.

# Readiness probe

컨테이너의 상태 체크중에 liveness의 경우에는 컨테이너가 비정상적으로 작동이 불가능한 경우도 있지만, Configuration을 로딩하거나, 많은 데이타를 로딩하거나, 외부 서비스를 호출하는 경우에는 일시적으로 서비스가 불가능한 상태가 될 수 있다. 이런 경우엔 컨테이너를 재시작한다 하더라도 정상적으로 서비스가 불가능할 수 있다. 컨테이너를 일시적으로 서비스가 불가능한 상태로 마킹 해주면 되는데, 이러한 기능은 쿠버네티스의 서비스와 함께 사용하면 유용하게 이용할 수 있다.

예를 들어 쿠버네티스 서비스에서 위와 같이 3개의 Pod를 로드밸런싱으로 서비스를 하고 있을때, Readiness probe 를 이용해서 서비스 가능 여부를 주기적으로 체크한다고 하자. 이 경우 하나의 Pod가 서비스가 불가능한 상태가 되었을때는,(즉, Readiness Probe에 대해서 응답이 없거나 실패 응답을 보냈을때) 해당 Pod를 사용 불가능한 상태로 체크하고 서비스 목록에서 제외한다.

(2) 헬스체크 확인을 위한 이미지 만들기

우선 아래 파일 2개 작성한다.

Dockerfile



FROM alpine:latest

RUN apk update && apk add --no-cache nodejs npm

WORKDIR /
ADD ./package.json /
RUN npm install
ADD ./webapl.js /
CMD node /webapl.js

webapl.js



const express = require('express')
const app = express()
var start = Date.now()
// Liveness 프로브 핸들러
// 기동 후 40초가 되면, 500 에러를 반환한다.
// 그 전까지는 HTTP 200 OK를 반환한다.
// 즉, 40초가 되면, Liveness프로브가 실패하여 컨테이너가 재기동한다. 
//
app.get('/healthz', function(request, response) {
var msec = Date.now() - start
    var code = 200
if (msec > 40000 ) {
	code = 500
}
    console.log('GET /healthz ' + code)
    response.status(code).send('OK')
})
// Rediness 프로브 핸들러
// 애플리케이션의 초기화 시간으로 
// 기동 후 20초 지나고 나서부터 HTTP 200을 반환한다. 
// 그 전까지는 HTTPS 200 OK를 반환한다.
app.get('/ready', function(request, response) {
var msec = Date.now() - start
    var code = 500
if (msec > 20000 ) {
	code = 200
}
    console.log('GET /ready ' + code)
    response.status(code).send('OK')
})
// 첫 화면
//
app.get('/', function(request, response) {
    console.log('GET /')
    response.send('Hello from Node.js')
})
// 서버 포트 번호
//
app.listen(3000);

hc-pod.yaml



apiVersion: v1
kind: Pod
metadata:
name: webapl
spec:
containers:
- name: webapl
    image: [이미지]            # (1)핸들러를 구현한 애플리케이션
                                  ex) minji/hc-repo:1.0
livenessProbe:            # (2)애플리케이션이 살아있는지 확인
      httpGet:
path: /healthz        # 확인 경로
        port: 3000
initialDelaySeconds: 3  # 검사 개시 대기 시간
      periodSeconds: 5        # 검사 간격

    readinessProbe:           # (3) 애플리케이션이 준비되었는지 확인
      httpGet:
path: /ready          # 확인 경로
        port: 3000
initialDelaySeconds: 15
periodSeconds: 6

hc-test 이미지 생성 :



docker build --tag [도커허브ID]/[레포지터리 이름]:[버전]



[ex]
docker build --tag ghdalswl77/hc-test:1.0 ./

생성한 이미지 실행 :



docker run -d --name [컨테이너 이름] [도커허브ID]/[레포지터리 이름]:[버전]




[ex]
docker run -d --name test ghdalswl77/hc-test:1.0

IP 확인 :



docker inspect [컨테이너 이름]

접속 :



curl http://[컨테이너 IP]:3000/healthz -v



curl http://172.17.0.2:3000/healthz -v

webapl.js 파일에 작성한대로 접속한 후 금방은 이렇게 뜨고..

조금 지나면 이렇게 뜰 것이다.

그럼 방금 생성한 이미지를 도커 허브에 올려보자.

도커 로그인하고,



docker login

레포지터리 업로드



docker push ghdalswl77/hc-test:1.0

이제 pod 를 방금 업로드한 이미지로 생성해보자.

[hc-pod.yaml]



apiVersion: v1
kind: Pod
metadata:
name: webapl
spec:
containers:
- name: webapl
    image: [이미지]    # (1)핸드러를 구현한 애플리케이션  ex) ghdalswl/hc-repo:1.0
livenessProbe:    # (2)애플리케이션이 살아있는지 확인
      httpGet:
path: /healthz   # 확인 경로
        port: 3000
initialDelaySeconds: 3  # 검사 개시 대기 시간
      periodSeconds: 5        # 검사 간격
    readinessProbe:           # (3) 애플리케이션이 준비되었는지 확인
      httpGet:
path: /ready          # 확인 경로
        port: 3000
initialDelaySeconds: 15
periodSeconds: 6

Pod 생성:



kubectl apply -f  [파일명]

Pod 확인:



kubectl get pods -o wide

죽었다 살아났다를 반복하고 있다..! 🧟‍♀️



kubectl describe pod webapl