Kubernetes Workload YAML 작성 가이드
Kubernetes에서 가장 자주 작성되는 매니페스트는 Deployment, Pod, StatefulSet입니다. Deployment는 무중단 롤링 업데이트와 ReplicaSet 자동 관리를 제공하며, Pod는 가장 작은 배포 단위이지만 직접 작성하기보다는 컨트롤러가 만든 Pod를 사용하는 것이 권장됩니다. StatefulSet은 안정적인 네트워크 ID와 영구 볼륨이 필요한 데이터베이스/카프카 같은 워크로드에 적합합니다.
핵심 필드
apiVersion: Deployment/StatefulSet은apps/v1, Pod는v1입니다.spec.replicas: 원하는 Pod 복제본 수.spec.selector.matchLabels: 어떤 Pod를 관리할지 결정하는 라벨 셀렉터(반드시 template.metadata.labels와 일치).spec.template: 생성될 Pod 템플릿. 여기에 컨테이너·볼륨이 들어갑니다.containers[].resources:requests(스케줄링 기준)와limits(상한). 한 자릿수의 OOM Kill을 방지하려면 메모리 limits를 신중히 설정합니다.readinessProbe: 트래픽을 받을 준비가 되었는지 확인. 실패 시 Service에서 제외됩니다.livenessProbe: 죽은 컨테이너를 재시작하기 위한 헬스체크.
프로브 사용 팁
readinessProbe와 livenessProbe는 비슷해 보이지만 역할이 다릅니다. readiness가 실패한 Pod는 Service의 엔드포인트에서 제외되어 트래픽을 받지 않지만, 컨테이너는 살아있는 상태로 유지됩니다. liveness가 실패한 Pod는 kubelet이 재시작합니다. 부팅 시간이 긴 애플리케이션은 startupProbe로 초기 부팅 단계의 liveness 실패를 막아주세요.
리소스 단위
CPU는 밀리코어(500m = 0.5 코어)와 정수(1 = 1 코어)를 사용합니다. 메모리는 IEC 바이너리(Mi=2^20, Gi=2^30) 또는 십진수(M·G)를 쓰며, 일반적으로 Mi/Gi가 권장됩니다.
자주 묻는 질문 (FAQ)
Q. Pod를 직접 만드는 것과 Deployment의 차이?
A. 직접 만든 Pod는 노드 장애 시 다시 생성되지 않지만, Deployment는 ReplicaSet이 자동으로 새 Pod를 만들어 복구합니다. 운영에서는 항상 Deployment/StatefulSet을 사용하세요.
Q. ConfigMap을 환경변수로 가져오려면?
A. envFrom: - configMapRef: 또는 env: - valueFrom: configMapKeyRef:를 사용합니다. 본 빌더는 환경변수를 단순 키=값으로 받지만, 생성된 YAML을 편집해 referenced 형태로 바꿀 수 있습니다.
Q. 적용 명령은?
A. kubectl apply -f deployment.yaml입니다. 변경 후 동일 명령으로 재적용하면 롤링 업데이트가 자동 수행됩니다.