nodeSelector와 Node Affinity로 배포 노드 제한하기 · Kubernetes
Deployment의 Pod 템플릿에 조건을 넣어 실제 배치 가능한 노드를 제한합니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
nodeSelector는 모두 만족
노드 label의 key/value가 nodeSelector의 모든 항목과 맞아야 합니다. Deployment에서는 spec.template.spec.nodeSelector에 넣습니다. Deployment 자체 metadata의 label은 노드를 선택하지 않습니다.
필수와 선호 조건
requiredDuringSchedulingIgnoredDuringExecution은 반드시 만족해야 하는 배치 조건, preferredDuringSchedulingIgnoredDuringExecution은 가능한 경우의 선호입니다. nodeSelector와 required affinity를 동시에 쓰면 둘 다 만족해야 합니다.
AND·OR와 실행 이후
같은 nodeSelectorTerm 안의 matchExpressions는 AND, 여러 term은 OR입니다. IgnoredDuringExecution은 배치 후 label이 바뀌어도 기존 Pod를 자동 퇴거시키지 않는다는 뜻입니다. nodeName 직접 지정은 scheduler 선택을 우회하므로 일반적인 배치 제한과 구분합니다.
왜 필요한가요?
디스크 특성이나 라이선스 때문에 특정 노드에서만 실행해야 하는 앱은 “가급적 그 노드”가 아니라 필수 조건을 선언해야 합니다. 조건이 맞는 노드가 없다면 다른 곳으로 보내지 않고 Pending으로 남는 것이 의도일 수 있습니다.
차례대로 이해하기
템플릿 위치 확인
Deployment의 metadata와 Pod 템플릿은 다릅니다. nodeSelector·affinity는 template.spec 아래에 두고 최종 생성된 Pod spec에도 조건이 들어갔는지 확인합니다. label의 값은 노드 이름과 같다고 가정하지 말고 실제 값을 읽습니다.
실패한 새 Pod 확인
없는 label을 요구하면 새 revision의 Pod가 Pending이 됩니다. 이전 Ready Pod가 남아 있을 수 있으므로 “하나가 Running이다”만으로 새 설정 성공을 판단하지 않습니다. 소유 ReplicaSet과 Pod의 nodeName을 비교합니다.
직접 실행하며 익혀보세요.
kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. cert-manager와 VPA 실습은 각 레슨에 명시한 사전 설치가 필요합니다. 노드 변경 실습은 폐기 가능한 전용 worker에서만 수행하며 전용 namespace를 사용합니다.
최소 하나의 Ready·스케줄 가능한 실습 worker가 필요합니다. 첫 목록에서 선택한 노드 이름을 export STUDY_NODE=실제노드이름 으로 설정한 뒤 실행하세요. 해당 노드의 기존 hostname label을 읽으며 Node label을 변경하지 않습니다. study.greatjin.net/missing-pool=unavailable 조건을 만족하는 노드가 없는 실습 환경을 사용합니다.
(
set -eu
kubectl config current-context
kubectl get nodes -L kubernetes.io/hostname
: "${STUDY_NODE:?Set STUDY_NODE to a Ready schedulable practice worker name}"
study_host=$(kubectl get node "$STUDY_NODE" -o jsonpath='{.metadata.labels.kubernetes\.io/hostname}')
test -n "$study_host"
kubectl create namespace study-node-placement --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-node-placement -f - <<YAML
apiVersion: apps/v1
kind: Deployment
metadata:
name: pinned
spec:
replicas: 1
selector:
matchLabels: {app: pinned}
template:
metadata:
labels: {app: pinned}
spec:
nodeSelector:
kubernetes.io/hostname: "$study_host"
containers:
- name: worker
image: busybox:1.36
command: ["sleep", "3600"]
resources:
requests: {cpu: 10m, memory: 16Mi}
limits: {cpu: 100m, memory: 64Mi}
YAML
kubectl rollout status deployment/pinned -n study-node-placement --timeout=120s
kubectl get pods -n study-node-placement -o wide
kubectl patch deployment pinned -n study-node-placement --type=merge -p '{"spec":{"template":{"spec":{"nodeSelector":null,"affinity":{"nodeAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"study.greatjin.net/missing-pool","operator":"In","values":["unavailable"]}]}]}}}}}}}'
kubectl rollout status deployment/pinned -n study-node-placement --timeout=15s || true
kubectl get pods -n study-node-placement -o wide
kubectl get events -n study-node-placement --field-selector reason=FailedScheduling
kubectl patch deployment pinned -n study-node-placement --type=merge -p "{\"spec\":{\"template\":{\"spec\":{\"affinity\":{\"nodeAffinity\":{\"requiredDuringSchedulingIgnoredDuringExecution\":{\"nodeSelectorTerms\":[{\"matchExpressions\":[{\"key\":\"kubernetes.io/hostname\",\"operator\":\"In\",\"values\":[\"$study_host\"]}]}]}}}}}}}"
kubectl rollout status deployment/pinned -n study-node-placement --timeout=120s
kubectl get pods -n study-node-placement -l app=pinned -o jsonpath='{range .items[*]}{.metadata.name}{" "}{.spec.nodeName}{"\n"}{end}'
)이렇게 확인하세요
처음 Pod의 nodeName이 선택한 worker인지 확인합니다. 없는 필수 label로 바꾸면 새 Pod가 Pending이고 FailedScheduling 이벤트가 나타납니다. 기존 Pod는 롤링 업데이트 정책에 따라 계속 동작할 수 있습니다. hostname affinity로 복구한 뒤 새 Ready Pod의 nodeName을 확인합니다.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
kubectl delete namespace study-node-placement응용해보기
zone=a만 허용해야 하는데 preferred affinity를 썼고 앱이 zone=b에 배치됐습니다. 버그일까요?
생각해본 뒤 풀이 보기
preferred는 선호이므로 가능한 동작입니다. 반드시 a여야 한다면 required 조건을 사용하고 a의 용량·taint도 확인합니다. 조건을 강화하면 배치 불가능할 때 Pending이 되는 결과를 운영 요구와 함께 받아들여야 합니다.
잠깐, 이해했는지 확인해볼까요?
특정 노드 집합 밖으로 절대 배치되면 안 되는 앱에 사용할 조건은?
- preferred affinity만 지정
- required node affinity 또는 nodeSelector
- Deployment metadata의 label만 변경
- Service selector만 지정
생각해본 뒤 풀이 보기
required node affinity 또는 nodeSelector
필수 배치 조건을 사용합니다. preferred는 선호이므로 다른 노드로 갈 수 있고 Service selector는 트래픽 대상 선택입니다.