Docs

Kubernetes는 컨테이너를 여러 노드에 배치하고, 죽으면 되살리고, 트래픽을 이어 주는 컨테이너 오케스트레이션 플랫폼입니다. 이 노트는 Kubernetes 공식 문서와 소스 저장소를 바탕으로, 컨테이너는 알지만 Kubernetes는 처음인 엔지니어도 아키텍처부터 운영까지 따라올 수 있도록 정리했습니다.

왼쪽 사이드바에서 챕터를 선택해 읽거나, 아래 차례에서 원하는 Part로 들어가세요. 처음이라면 Part I → II → IV 순서를 권합니다.

차례

• Part I. 시작하기 — Kubernetes란·컨테이너 기초·학습 환경·첫 배포
• Part II. 클러스터 아키텍처 — apiserver·etcd·스케줄러·kubelet·kube-proxy
• Part III. 오브젝트 모델과 kubectl — spec/status·매니페스트·label·namespace
• Part IV. 워크로드 — Pod·프로브·Deployment·StatefulSet·Job
• Part V. 네트워킹 — 네트워크 모델·Service·DNS·Ingress·NetworkPolicy
• Part VI. 스토리지 — 볼륨·PV/PVC·StorageClass·CSI·스냅샷
• Part VII. 구성과 시크릿 — ConfigMap·Secret·주입 패턴
• Part VIII. 스케줄링과 자원 관리 — requests/limits·QoS·affinity·taint·eviction·오토스케일링
• Part IX. 보안 — 인증·RBAC·ServiceAccount·Pod Security·어드미션
• Part X. 관측성과 트러블슈팅 — 로깅·메트릭·이벤트·흔한 장애 패턴
• Part XI. 클러스터 운영 — kubeadm·업그레이드·etcd 백업·노드 관리·인증서
• Part XII. 패키징과 확장 — Helm·Kustomize·CRD·Operator·GitOps

표기 규약

• 본문 산문은 Kubernetes 풀네임 (K8s는 표 안에서만)
• 특정 버전에 고정하지 않고, 버전에 따라 갈리는 기능은 GA된 버전을 본문에 명시합니다
• Kubernetes 고유 용어(Pod, Deployment, Service, kubelet, taint, affinity, eviction, control plane 등)는 번역하지 않고 영문 그대로
• 매니페스트(YAML)·명령(kubectl)·필드 경로(.spec.replicas)는 그대로 복사해 쓸 수 있는 형태로
• 모든 도식은 Mermaid
• 공식 문서 원문: https://kubernetes.io/docs/

관련 사이트

• CloudNativePG 노트: dbalog.dev/cnpg
• Patroni 노트: dbalog.dev/patroni
• PostgreSQL 노트: dbalog.dev/pg
• 파라미터 레퍼런스: dbalog.dev/pg-conf
• 메인 블로그: dbalog.dev