容器与云原生 / 系统课时
节点选择器
节点选择器
当某类 Pod 必须落到带有指定硬件、机房或用途标签的节点时,可以用 nodeSelector 做最直接的约束。本课将完成节点打标、Pod 配置、调度验证,并说明无匹配节点时如何定位。
学习目标
- 理解节点标签与
nodeSelector的精确匹配规则 - 配置一个只允许调度到指定节点的 Pod
- 根据 Pod 事件定位标签不匹配问题
nodeSelector 的匹配机制
nodeSelector 位于 Pod 的 spec 中,键和值必须与节点标签完全一致。配置多个键时采用“全部满足”的与关系;缺少任一标签或值不相等,该节点都会被调度器过滤。

节点标签只描述属性,不会自动隔离节点。没有调度约束的其他 Pod 仍可能进入该节点;需要从节点侧排斥普通工作负载时,应使用污点与容忍度。
配置并调度 Pod
先选择一个可用节点并添加自定义标签。实际执行前将 <NODE_NAME> 替换为节点名。
bash
kubectl get nodes
kubectl label node <NODE_NAME> example.com/storage-tier=ssd --overwrite预期输出中,角色、版本和运行时长会因集群而异:
text
NAME STATUS ROLES AGE VERSION
<NODE_NAME> Ready <ROLE> <AGE> <VERSION>
node/<NODE_NAME> labeled将下面内容保存为 pod-node-selector.yaml。只有带有目标标签的节点能够通过筛选。
yaml
apiVersion: v1
kind: Pod
metadata:
name: node-selector-demo
labels:
app: node-selector-demo
spec:
restartPolicy: Never
nodeSelector:
example.com/storage-tier: ssd
containers:
- name: web
image: nginx:1.27-alpine
ports:
- name: http
containerPort: 80应用配置并等待 Pod 就绪:
bash
kubectl apply -f pod-node-selector.yaml
kubectl wait --for=condition=Ready pod/node-selector-demo --timeout=120s
kubectl get pod node-selector-demo -o wide预期结果中,NODE 列应为已打标签的节点;IP 和时间是动态值:
text
pod/node-selector-demo created
pod/node-selector-demo condition met
NAME READY STATUS RESTARTS AGE IP NODE
node-selector-demo 1/1 Running 0 <TIME> <IP> <NODE_NAME>验证、排错与使用边界
同时查看 Pod 的选择条件、实际节点和节点标签,可以确认调度是否符合预期:
bash
kubectl get pod node-selector-demo -o jsonpath='{.spec.nodeSelector}{"\n"}{.spec.nodeName}{"\n"}'
kubectl get node <NODE_NAME> --show-labels预期结果应同时出现选择器、实际节点名和目标标签:
text
{"example.com/storage-tier":"ssd"}
<NODE_NAME>
<NODE_NAME> Ready <ROLE> <AGE> <VERSION> ...example.com/storage-tier=ssd...若没有匹配节点,Pod 会保持 Pending。执行 kubectl describe pod node-selector-demo,在 Events 中通常能看到类似信息:
text
Warning FailedScheduling <TIME> default-scheduler 0/<N> nodes are available: <N> node(s) didn't match Pod's node affinity/selector.应依次核对标签键、标签值、大小写和节点 Ready 状态。修改节点标签后调度器会重试,但已经运行的 Pod 不会因标签变化而自动迁移。nodeSelector 适合固定值精确匹配;需要候选值、逻辑表达式或软偏好时,应改用节点亲和性。
按自己的节奏,确认真正理解。