容器与云原生 / 系统课时
DaemonSet 节点级服务
DaemonSet 节点级服务
DaemonSet 用来把同一类节点代理自动部署到所有或部分合格节点。本课将完成一个可运行的节点代理清单,并掌握节点筛选、滚动部署、状态验证和常见调度失败的定位方法。
学习目标
- 说明 DaemonSet 与 Deployment 在副本目标上的差异
- 编写带标签选择器和节点选择条件的 DaemonSet
- 使用 kubectl 验证每个合格节点上的 Pod 状态
工作机制与清单
Deployment 关注“集群中需要多少个副本”,DaemonSet 关注“哪些节点必须各有一个副本”。日志采集器、监控代理、存储守护进程和网络组件通常需要贴近节点运行;当合格节点加入或移除时,控制器会相应创建或清理 Pod。:contentReference[oaicite:0]{index=0}

不设置 nodeSelector 或节点亲和性时,DaemonSet 会面向全部节点创建 Pod;设置后只覆盖匹配节点。最终能否运行还受污点、容忍、资源和镜像拉取等条件影响。:contentReference[oaicite:1]{index=1}
先选择一个测试节点并添加标签 node-agent=enabled。下面的清单让每个匹配节点运行一个轻量代理,代理每 30 秒输出所在节点名称。
apiVersion: apps/v1
kind: DaemonSet
metadata:
name: node-agent-demo
spec:
selector:
matchLabels:
app: node-agent-demo
template:
metadata:
labels:
app: node-agent-demo
spec:
nodeSelector:
node-agent: enabled
containers:
- name: agent
image: busybox:1.36.1
command: ["/bin/sh", "-c"]
args:
- |
while true; do
echo "node-agent running on ${NODE_NAME}"
sleep 30
done
env:
- name: NODE_NAME
valueFrom:
fieldRef:
fieldPath: spec.nodeName
resources:
requests:
cpu: 10m
memory: 16Mi
limits:
cpu: 50m
memory: 32Mi
terminationGracePeriodSeconds: 5保存为 daemonset-node-agent.yaml。spec.selector 必须匹配 Pod 模板标签,资源创建后该选择器不可修改;模板未显式设置 restartPolicy 时默认使用 Always,这也符合 DaemonSet 的要求。:contentReference[oaicite:2]{index=2}
部署并验证
把 <NODE> 替换为 kubectl get nodes 查到的真实节点名,然后执行部署、等待滚动完成并查看 Pod 分布。
kubectl label node <NODE> node-agent=enabled --overwrite
kubectl apply -f daemonset-node-agent.yaml
kubectl rollout status daemonset/node-agent-demo
kubectl get daemonset node-agent-demo
kubectl get pods -l app=node-agent-demo -o wide预期输出如下,节点名、Pod 名、数量和时间会随集群实际状态变化。
node/<NODE> labeled
daemonset.apps/node-agent-demo created
daemon set "node-agent-demo" successfully rolled out
NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE
node-agent-demo 1 1 1 1 1 node-agent=enabled <TIME>
NAME READY STATUS RESTARTS AGE IP NODE
node-agent-demo-<ID> 1/1 Running 0 <TIME> <IP> <NODE>DESIRED 应等于当前匹配节点数,READY 应逐步追平 DESIRED。再给另一个节点添加同样标签时,控制器会自动增加一个 Pod;移除标签后,对应 Pod 会被删除。:contentReference[oaicite:3]{index=3}
节点选择与故障定位
Pod 长时间为 Pending 时,先用 kubectl describe pod <POD> 查看事件。常见原因是节点标签不匹配、节点存在未容忍的污点、资源不足或镜像不可拉取。控制平面节点通常带专用污点,不应为了“数量一致”而盲目添加容忍;只有节点级能力确实需要覆盖该节点时才配置。
更新镜像或资源限制后,可用 kubectl rollout status daemonset/node-agent-demo 观察滚动更新。若变更 selector,API 会拒绝请求,应新建名称不同的 DaemonSet 或删除后重建。真实日志采集器若挂载宿主机目录,还要把 hostPath、只读权限和最小化安全权限纳入评审。