쿠버네티스Kubernetes
사용자가 원하는 상태를 API 객체로 적어 두면, 여러 제어 루프가 클러스터의 실제 상태를 관찰해 그 상태로 맞춰 가는 컨테이너 오케스트레이션 시스템이다.
1요약
- 쿠버네티스는 노드 여러 대를 클러스터 하나로 묶고 모든 구성 요소가 API 서버 하나를 거쳐 상태를 읽고 쓰는 오픈소스 시스템으로(1.0 = 2015-07 · 현행 1.37), 그 위에서 웹 API 의 파드 · 배치 Job · 노드마다 도는 로그 수집기가 함께 돈다.
- 노드 한 대가 꺼지면 사람이 그 위 응용을 손으로 다시 배치해야 했는데, 쿠버네티스는 기본값으로 50초 뒤 노드를 Unknown 으로 표시하고 300초를 더 기다린 뒤 파드를 축출해 대체 파드를 다른 노드에 띄운다(kube-controller-manager 참조 · Taints 문서).
- 「파드가 안 뜬다」는 어느 제어 루프에서 멈췄는가로 가른다 — Pending 이면 스케줄러, CrashLoopBackOff 면 kubelet 과 응용, Running 인데 서비스가 응답하지 않으면 끝점(EndpointSlice)이다.
2등장 배경
컨테이너가 퍼지기 전 서비스 회사는 서버 수십 대에 응용을 스크립트로 나눠 올렸고, 서버 한 대가 새벽에 꺼지면 당직자가 호출을 받아 다른 서버로 손수 옮겼다. 어느 서버에 무엇이 도는지는 운영자의 머릿속과 표에 흩어져 있어, 서버가 늘수록 옮기는 시간과 실수가 함께 늘었다.
구글은 이 일을 클러스터 관리자 Borg 에 맡겨 수만 대 규모 클러스터에서 10년 넘게 운영했고, 그 경험을 2015년 EuroSys 논문으로 공개했다(Verma 외 2015). Borg · Omega 를 만든 엔지니어들이 2014년 6월 6일 쿠버네티스 첫 커밋을 GitHub 에 올렸고, 2015년 7월 21일 1.0 과 함께 프로젝트가 리눅스 재단 산하 CNCF 로 넘어갔다(10 Years of Kubernetes).
2022년 5월 1.24 는 Docker 엔진을 잇던 dockershim 을 빼고 CRI 를 구현한 런타임(containerd · CRI-O)만 쓰게 했다(Dockershim FAQ). 지금은 2026년 8월 나온 1.37 이 최신이고, 프로젝트는 최근 세 마이너 판을 유지하며 판마다 약 1년 패치를 낸다(Kubernetes Releases).
3쉽게 이해하기 — 경비 용역 회사의 상시 배치 계약
고객이 경비 용역 회사 본사에 「건물 출입구에 경비원을 늘 3명 세워 달라」는 요청서를 낸다. 접수 창구는 요청서를 확인해 장부에 적고, 인원 담당은 장부와 출근부를 쉬지 않고 맞춰 보며 모자라면 사람을 보내라고 하고, 배치 담당은 일손이 남는 초소를 골라 준다. 초소 반장은 정해진 주기로 본사에 「이상 없음」을 알리는데, 초소 B 의 연락이 끊기자 본사는 5분을 기다린 뒤 초소 C 에 새 경비원을 세운다. 손님은 대표 번호 하나로 전화해 지금 근무 중인 경비원과 통화한다.
그림 1 · 요청서는 장부에 적히고, 본사 담당자들이 장부를 보며 초소마다 경비원을 세우며, 연락이 끊긴 초소의 몫은 다른 초소에 새 사람으로 채운다.
그림 2 · 인원 담당은 장부의 3명과 출근부의 2명을 견주어 모자란 1명만 채운다 — 실제로는 spec 과 status 를 견주는 제어 루프다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 고객 요청서 | 매니페스트(YAML) | 원하는 상태(spec)를 적어 kubectl apply 로 낸다 |
| 접수 창구 | kube-apiserver | 요청을 인증 · 검증하고, 모든 구성 요소가 읽고 쓰는 유일한 창구가 된다 |
| 장부 | etcd | 모든 API 객체를 저장하는 키-값 저장소 |
| 인원 담당 | 컨트롤러(ReplicaSet 등) | spec 과 실제 상태의 차이를 찾아 객체를 만들거나 지운다 |
| 배치 담당 | kube-scheduler | 노드가 정해지지 않은 파드에 노드를 골라 묶는다 |
| 초소 · 반장 | 노드 · kubelet | 자기 노드에 묶인 파드를 실행하고 상태와 생존 신호를 올린다 |
| 연락 두절 뒤 5분 | 노드 Unknown · toleration 300초 | 기다린 뒤 그 노드의 파드를 축출한다 |
| 대표 번호 | 서비스 · EndpointSlice | 고정 주소로 받은 요청을 준비된 파드로 나눈다 |
⚠ 비유가 맞지 않는 곳: 본사 직원은 서로 말로 지시하지만 쿠버네티스 구성 요소는 서로 부르지 않고 API 서버의 객체만 읽고 고친다. 또 경비원은 다른 초소로 옮겨 가지만, 파드는 옮겨지지 않고 같은 틀로 만든 새 파드가 대신 선다.
4구조 — API 서버 중심의 컨트롤 플레인과 노드
쿠버네티스 클러스터는 상태를 맞추는 컨트롤 플레인과 컨테이너를 실제로 돌리는 노드로 나뉜다(Kubernetes Components). 사용자 · 스케줄러 · 컨트롤러 · kubelet 은 모두 kube-apiserver 로만 객체를 읽고 쓰며, etcd 에 직접 닿는 것은 API 서버뿐이다.
그림 3 · 스케줄러 · 컨트롤러 · kubelet 은 서로 부르지 않고 API 서버 하나만 보며, 그 뒤의 etcd 가 클러스터의 모든 상태를 담는다.
| 요소 | 위치 | 역할 | 값 · 근거 |
|---|---|---|---|
| kube-apiserver | 컨트롤 플레인 | HTTP API 제공 · 인증 · 검증 · etcd 읽기 쓰기 | 모든 구성 요소의 유일한 통로(Components) |
| etcd | 컨트롤 플레인 | API 객체 전체를 담는 일관된 키-값 저장소 | 리더 기반 합의 · 홀수 구성 · 운영 5대 권장(etcd 운영 문서) |
| kube-scheduler | 컨트롤 플레인 | 노드가 없는 파드에 노드를 고름 | 필터링 → 점수 → 바인딩(Scheduler 문서) |
| kube-controller-manager | 컨트롤 플레인 | Deployment · ReplicaSet · 노드 수명 등 내장 컨트롤러 실행 | 노드 확인 5초 · 응답 유예 50초 · 축출 속도 0.1 노드/초(참조 문서) |
| kubelet | 노드마다 | 자기 노드에 묶인 파드의 컨테이너를 실행 · 상태 보고 | 생존 신호 = Node .status 와 kube-node-lease 의 Lease(Nodes 문서) |
| 컨테이너 런타임 | 노드마다 | 이미지를 받아 컨테이너 실행 | CRI 구현(containerd · CRI-O) · 1.24 에서 dockershim 제거 |
| kube-proxy | 노드마다(선택) | 서비스 주소를 끝점으로 보내는 망 규칙 유지 | EndpointSlice 가 경로의 기준(EndpointSlice 문서) |
🔑 쿠버네티스의 구성 요소는 서로 명령하지 않고 API 서버의 객체를 읽고 고칠 뿐이다 — 구성 요소를 잇는 것은 호출이 아니라 상태다.
5동작 — 노드 한 대가 꺼진 뒤의 자기 복구
노드 3대(node-a · node-b · node-c)에 Deployment shop-api(복제 3개 · 이미지 registry. · CPU 요청 500m)와 서비스 shop-api(ClusterIP 10.96.40.12:80)를 올린 뒤 node-b 의 전원이 끊기는 사례다. 노드 이름 · 이미지 · 주소 · 대체 파드가 준비되는 12초는 설명용 가정 값이고, 제어 값은 기본값이다.
- 사용자가
kubectl apply -f shop-api.을 실행하면 API 서버가 요청을 검증해yaml spec.replicas: 3인 Deployment 를 etcd 에 저장한다. - Deployment 컨트롤러가 ReplicaSet
shop-api-7d9c5b6f4(이름 꼬리 =pod-template-hash)를 만들고, ReplicaSet 컨트롤러가 노드가 비어 있는 파드 3개를 만든다(Deployments 문서). - 스케줄러가 CPU 요청 500m 을 채우는 노드를 필터링으로 남기고 점수를 매겨 파드마다
node-a·node-b·node-c를 하나씩 바인딩한다 — 점수가 같으면 무작위로 고른다(Scheduler 문서). - 각 노드의 kubelet 이 자기 노드에 묶인 파드를 보고 CRI 런타임으로 컨테이너를 시작하며, 준비된 파드는 EndpointSlice 에
ready: true로 올라10.96.40.12:80의 대상이 된다. - t = 0 초에
node-b전원이 끊겨 kubelet 의 Lease 갱신이 멈춘다 — 이 노드의 파드는 응답하지 않지만 API 객체는 그대로다. - 노드 수명 컨트롤러는 5초마다 노드를 확인하고, 50초 동안 소식이 없자 t ≈ 50 초에
node-b의 Ready 를 Unknown 으로 바꾸고node.테인트를 붙인다 — 이제 스케줄러는 이 노드에 새 파드를 두지 않는다(Nodes 문서).kubernetes. io/ unreachable: NoExecute - 파드에 자동으로 붙은 toleration 300초가 지난 t ≈ 350 초에 축출이 일어나 파드가 Terminating 이 되고, ReplicaSet 컨트롤러는 활성 파드를 2개로 세어 대체 파드 1개를 만든다(Taints 문서).
- 스케줄러가 테인트가 붙은
node-b를 걸러 내고node-c를 바인딩하며, t ≈ 362 초에 대체 파드가 준비되어 끝점이 다시 3개가 된다 — 옛 파드 객체는node-b가 돌아와 정리될 때까지 Terminating 으로 남을 수 있다(Taints 문서).
그림 4 · apply 한 번이 컨트롤러 → 스케줄러 → kubelet 으로 이어지고, 노드가 꺼지면 같은 연쇄가 50초 · 350초 표시를 계기로 다시 돈다.
그림 5 · 컨트롤러는 350초 동안 파드를 3개로 세지만 실제로 응답하는 파드는 2개다 — 자기 복구가 늦는 원인은 실행이 아니라 관찰 기준이다.
🔑 자기 복구는 고장을 «보는» 데서 시작하므로, 복구 시간은 컨테이너를 띄우는 속도가 아니라 관찰 기준(응답 유예 50초 · toleration 300초)이 정한다.
6비교 — Deployment · StatefulSet · DaemonSet · Job
같은 제어 루프 원리로 도는 내장 워크로드 컨트롤러는 «무엇을 원하는 상태로 보는가»가 다르다.
| 기준 | Deployment | StatefulSet | DaemonSet | Job |
|---|---|---|---|---|
| 원하는 상태 | 복제 N개 | 이름이 고정된 복제 N개 | 노드마다 1개 | 성공 완료 N회 |
| 파드 이름 | 무작위 꼬리(해시) | web-0 ~ web-(N-1) 순번 | 노드마다 무작위 꼬리 | 무작위 꼬리 |
| 생성 순서 | 한꺼번에 · 롤링 업데이트(maxSurge · maxUnavailable 기본 25%) | 기본 OrderedReady — 앞 순번이 Ready 여야 다음 | 노드가 늘면 자동 추가 | parallelism 만큼 동시 |
| 저장소 | 파드끼리 공유하거나 없음 | volumeClaimTemplates 로 파드마다 PVC · 지워도 볼륨 보존 | 노드 로컬 경로가 흔함 | 결과를 밖에 씀 |
| 끝 | 없음(계속 유지) | 없음 | 없음 | 완료 수에 이르면 Finished |
| 대표 용도 | 상태 없는 웹 · API | DB · 메시지 큐 | 로그 수집 · 노드 감시 | 일괄 계산 · 이관 |
분석파드가 서로 바꿔 써도 되면 Deployment, 순번 · 볼륨이 파드에 붙어 있어야 하면 StatefulSet, 노드마다 하나여야 하면 DaemonSet, 끝이 있는 일이면 Job 을 고른다. 근거는 표의 「원하는 상태」 · 「저장소」 행과 StatefulSet 문서의 고정 식별(순번 · 네트워크 ID · 저장소) 규정이다.
7실무 진단 — 멈춘 제어 루프 가르기
분석먼저 kubectl get pods -o wide 의 STATUS 와 NODE 로 어느 제어 루프에서 멈췄는지 고른 뒤 그 루프의 기록을 본다. 노드가 비어 있으면 스케줄러, 노드는 있는데 재시작이 늘면 kubelet · 응용, Running 인데 응답이 없으면 끝점이라는 순서는 그림 4 의 연쇄 순서와 같다.
| # | 증상 | 의심 원인 | 구분 | 확인 명령 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 파드가 Pending 에 머묾 | 요청 CPU · 메모리를 채우는 노드 없음 · 테인트 | 스케줄러 | kubectl describe pod <파드> 의 Events | 스케줄러가 남긴 배치 불가 사유가 보임(Debug Pods) |
| 2 | RESTARTS 가 늘고 CrashLoopBackOff | 응용이 시작 직후 끝남 | kubelet · 응용 | kubectl logs <파드> --previous | 직전 컨테이너 로그에 종료 원인 · 재시작 간격 10 · 20 · 40초 … 최대 300초(Pod Lifecycle) |
| 3 | 파드는 Running 인데 서비스 주소가 응답 없음 | readiness 실패 · 셀렉터 불일치 | 서비스 · 끝점 | kubectl get endpointslices -l kubernetes. | ready: true 끝점이 0개(EndpointSlice 문서 Conditions) |
| 4 | 한 노드의 파드가 Terminating 에서 멈춤 | 노드 단절 | 노드 수명 컨트롤러 | kubectl get nodes · kubectl describe node <노드> | Ready = Unknown · node. 테인트(Taints 문서) |
Pending 을 가장 먼저 보는 까닭은 노드가 없으면 kubelet 로그 · 끝점이 아예 생기지 않기 때문이다. 단절된 노드의 Terminating 파드는 API 서버가 kubelet 에 삭제를 알리지 못해 그 노드에서 계속 돌 수도 있으므로(Taints 문서), 같은 디스크를 쓰는 응용이면 노드를 먼저 확인한다.
8시험 대비
www.q-net.or.kr시험에서는 원하는 상태 · 제어 루프 · 구성 요소를 묻는 정의 · 특징형과, 노드 장애 뒤 자기 복구 과정을 묻는 동작 · 절차 설명형이 나올 수 있다. 정의형은 그림 3 으로 API 서버 중심 구성을 먼저 보이고 spec ↔ status 를 한 줄로 정의하며, 절차형은 순서도와 두 값 그래프로 50초 · 300초를 짚는다. 컨테이너 격리 원리는 가상 머신 · 컨테이너에서 다루고, 배포 파이프라인(CI/CD)은 여기서 다루지 않는다.
- 개요 — 정의 · Borg → Omega → Kubernetes 계보 · 선언형 API(spec = 원하는 상태 · status = 실제 상태)
- 구성 요소 — 그림 3 컨트롤 플레인 · 노드 구조 + 요소 표(API 서버 · etcd 5대 · 스케줄러 · 컨트롤러 매니저 · kubelet · kube-proxy)
- 제어 루프 원리 — 관찰 → 비교 → 조치 · 컨트롤러는 API 서버에만 요청 · 실행은 kubelet
- 스케줄링 — 필터링 → 점수 → 바인딩 · 맞는 노드가 없으면 Pending
- 자기 복구 절차 — 그림 4 순서도(t = 0 → 50초 Unknown → 350초 축출 → 대체 파드) + 그림 5 두 값 그래프
- 워크로드 비교 · 동향 — Deployment · StatefulSet · DaemonSet · Job 표 · 현행 1.37 · 최근 세 마이너 판 유지
꼭 쓸 키워드
원하는 상태제어 루프kube-apiserveretcdkube-schedulerkubelet파드ReplicaSet테인트EndpointSlice
차이를 내는 한 가지는 그림 5 처럼 «컨트롤러가 세는 수»와 «실제로 응답하는 수»를 따로 그려 350초의 관찰 지연과 그 값을 정하는 두 설정을 보이는 것이다.
9오해와 사실
- 오해쿠버네티스는 고장 난 노드의 파드를 다른 노드로 옮긴다.사실UID 가 같은 파드는 다른 노드로 다시 배치되지 않고, 같은 템플릿으로 만든 새 파드가 대신 선다(Pod Lifecycle 문서).
- 오해readiness 검사가 실패하면 컨테이너가 다시 시작된다.사실readiness 는 파드의 Ready 조건만 바꿔 EndpointSlice 의 serving 에서 빼고(EndpointSlice 문서), 컨테이너를 죽이고 재시작하는 것은 startup · liveness 검사 실패다(Pod Lifecycle 문서).
- 오해etcd 를 2대로 늘리면 1대보다 안전하다.사실etcd 는 리더 기반 합의라 과반이 살아 있어야 쓰기가 되므로 2대는 1대만 죽어도 멈추고, 그래서 홀수로 두며 운영은 2대 고장을 견디는 5대를 권한다(etcd 운영 문서).
10핵심 정리
| 구분 | 맡는 일 | 보는 것 | 바꾸는 것 | 기본값 · 수치 |
|---|---|---|---|---|
| kube-apiserver | 모든 읽기 · 쓰기의 창구 | 요청 · 인증 정보 | etcd 의 객체 | 구성 요소끼리 직접 호출 없음 |
| etcd | 클러스터 상태 저장 | — | — | 홀수 · 운영 5대 |
| kube-scheduler | 노드 고르기 | 노드가 빈 파드 | nodeName 바인딩 | 필터링 → 점수 → 바인딩 |
| ReplicaSet 컨트롤러 | 복제 수 맞추기 | spec.replicas ↔ 활성 파드 | 파드 생성 · 삭제 | Deployment 롤링 25% · 이력 10개 |
| 노드 수명 컨트롤러 | 노드 고장 판정 | Lease · Node status | Ready Unknown · 테인트 | 5초 확인 · 50초 유예 · toleration 300초 |
| kubelet | 파드 실행 | 자기 노드에 묶인 파드 | 컨테이너 · 상태 보고 | 재시작 간격 10초 → 최대 300초 |
| 서비스 · EndpointSlice | 고정 주소 · 대상 목록 | 셀렉터에 맞는 파드 | 끝점 ready · serving · terminating | 슬라이스당 기본 100개 |
11참고 문헌
- 먼저 볼 문헌
- ★ Kubernetes Components — 컨트롤 플레인과 노드 구성 요소의 역할을 원문으로 볼 때
- ★ Controllers — 제어 루프가 원하는 상태와 현재 상태를 맞추는 방식을 볼 때
- ★ Kubernetes Scheduler — 필터링 · 점수 매기기 · 바인딩 순서를 볼 때
- ★ Taints and Tolerations (Taint based Evictions) — 노드 장애 뒤 300초 toleration 과 축출 규칙을 볼 때
- ★ Large-scale cluster management at Google with Borg — 쿠버네티스 이전 구글 클러스터 관리자의 설계를 볼 때
- 본문 근거
- Borg, Omega, and Kubernetes — B. Burns · B. Grant · D. Oppenheimer · E. Brewer · J. Wilkes · ACM Queue 14 · 2016-03 ·
queue.acm.org/detail.cfm?id=2898444· 확인 2026-11-03 - Objects In Kubernetes — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/overview/working-with-objects/· 확인 2026-11-03 - Deployments — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/workloads/controllers/deployment/· 확인 2026-11-03 - Nodes — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/architecture/nodes/· 확인 2026-11-03 - kube-controller-manager (command line tools reference) — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/· 확인 2026-11-03 - Pod Lifecycle — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/· 확인 2026-11-03 - EndpointSlices — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/services-networking/endpoint-slices/· 확인 2026-11-03 - StatefulSets — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/workloads/controllers/statefulset/· 확인 2026-11-03 - DaemonSet — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/workloads/controllers/daemonset/· 확인 2026-11-03 - Jobs — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/concepts/workloads/controllers/job/· 확인 2026-11-03 - Operating etcd clusters for Kubernetes — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/tasks/administer-cluster/configure-upgrade-etcd/· 확인 2026-11-03 - Debug Pods — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/tasks/debug/debug-application/debug-pods/· 확인 2026-11-03 - kubectl logs (kubectl reference) — The Kubernetes Authors · 2026-11 ·
kubernetes.io/docs/reference/kubectl/generated/kubectl_logs/· 확인 2026-11-03 - Kubernetes Releases — The Kubernetes Authors · 2026-11 ·
kubernetes.io/releases/· 확인 2026-11-03 - Kubernetes v1.37: Garhwal — Kubernetes Blog · 2026-08 ·
kubernetes.io/blog/2026/08/26/kubernetes-v1-37-release/· 확인 2026-11-03 - 10 Years of Kubernetes — Kubernetes Blog · 2024-06 ·
kubernetes.io/blog/2024/06/06/10-years-of-kubernetes/· 확인 2026-11-03 - Dockershim Removal FAQ — Kubernetes Blog · 2022-02 ·
kubernetes.io/blog/2022/02/17/dockershim-faq/· 확인 2026-11-03