🔄 서비스 중단 없이 업데이트하기 – Kubernetes Deployment 완전 정복

단일 파드의 문제점이 뭔지 아시나요? 죽으면 그냥 끝입니다. 자동으로 살아나지 않아요. 게다가 새 버전을 배포하려면 기존 파드를 내리고 새 걸 올리는 동안 서비스가 끊깁니다. 이 두 가지 문제를 동시에 해결하는 게 Deployment입니다. 고가용성(HA)과 무중단 배포(Zero-downtime)를 쿠버네티스가 알아서 처리해주죠.

---

🎯 Deployment가 해결하는 3가지

• 복수 실행: Replicas로 파드를 여러 개 유지 → 하나 죽어도 나머지가 트래픽 처리
• 롤링 업데이트: 구버전 파드를 하나씩 내리고 신버전을 하나씩 올림 → 서비스 무중단
• 롤백: 새 버전에 문제가 생기면 이전 버전으로 즉시 복구

---

🏗️ Deployment 생성 — YAML 작성

# nginx-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3                    # 파드 3개를 항상 유지
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.20        # 처음엔 1.20 버전으로 시작
        ports:
        - containerPort: 80

kubectl apply -f nginx-deployment.yaml

# ReplicaSet과 파드가 모두 생성됐는지 확인
kubectl get deployment,replicaset,pods

Deployment를 만들면 자동으로 ReplicaSet이 생성되고, ReplicaSet이 파드 3개를 만듭니다. Deployment → ReplicaSet → Pod 구조입니다.

---

🚀 롤링 업데이트

이제 nginx를 1.20에서 1.21로 올려봅시다.

kubectl set image deployment/nginx-deployment nginx=nginx:1.21

# 실시간 진행 상황 확인
kubectl rollout status deployment/nginx-deployment

업데이트가 진행되는 동안 kubectl get pods를 치면 이런 모습이 보입니다:

NAME                                   STATUS              RESTARTS
nginx-deployment-old-xxx               Terminating         0
nginx-deployment-new-yyy               ContainerCreating   0
nginx-deployment-new-zzz               Running             0

구버전(1.20) 파드가 하나씩 내려가고, 신버전(1.21) 파드가 하나씩 올라오는 과정입니다. 이 동안 서비스는 계속 살아있습니다.

---

⏪ 롤백 — 뭔가 잘못됐을 때

배포 히스토리를 보면 각 버전이 Revision으로 관리됩니다.

# 배포 이력 확인
kubectl rollout history deployment/nginx-deployment

# 이전 버전(Revision 1)으로 롤백
kubectl rollout undo deployment/nginx-deployment

# 특정 버전으로 롤백하려면
kubectl rollout undo deployment/nginx-deployment --to-revision=1

# 롤백 후 이미지 버전 확인
kubectl describe deployment nginx-deployment | grep Image

---

🔍 롤백의 동작 원리 — 헷갈리기 쉬운 부분

롤백 후 히스토리를 보면 이상한 일이 일어납니다.

REVISION  CHANGE-CAUSE
2         nginx=nginx:1.21
3         nginx=nginx:1.20  ← rollback!

Revision 1이 사라지고 3이 생겼습니다. 왜일까요?

쿠버네티스의 롤백은 “시간을 되돌리는” 게 아닙니다. Revision 1의 설정을 복사해서 새로운 Revision 3으로 적용하는 겁니다. Re-deployment죠. 중복 방지를 위해 기존 Revision 1은 목록에서 제거됩니다. 이건 GitOps의 “선언적 상태 관리” 철학과 정확히 같습니다.

---

🚨 삽질 포인트 — 파드가 Pending에서 안 넘어가요

Deployment를 배포했는데 파드가 죄다 Pending 상태에 멈춰있었습니다.

kubectl describe pod <파드명>

Events에 이런 메시지가 있었습니다:

0/3 nodes are available: 1 node has taint {control-plane},
2 nodes had untolerated taint {node.kubernetes.io/unreachable}

해석하면: 마스터는 스케줄링 제외(정상)이고, 워커 노드 2대가 “연락 두절(Unreachable)” 상태라서 파드 배치할 곳이 없다는 뜻입니다.

원인은 VM을 절전 모드로 뒀다가 깨어난 후 kubelet이 죽어있었던 것이었습니다.

# 각 워커 노드에서 실행
sudo systemctl restart kubelet

워커 노드 상태가 Ready로 돌아오자마자 Pending이던 파드들이 즉시 Running으로 전환됐습니다.

---

💡 정리

Deployment를 쓰면 쿠버네티스가 “이 상태를 유지해줘” 라는 선언만으로 파드 개수 유지, 무중단 업데이트, 롤백을 전부 처리해줍니다.

파드를 단일로 쓰는 건 DB 테스트용이나 일회성 작업 외엔 거의 없습니다. 실제 서비스는 대부분 Deployment입니다.

다음 글에서는 이 Deployment들을 외부에서 접근할 수 있게 만드는 Service를 다룹니다.