树莓派4B搭建K3S集群:接入Agent节点后kubectl命令执行超时
树莓派4B搭建K3S集群接入Agent后kubectl命令超时问题
问题现象
- 服务端以单节点独立模式运行时,执行所有kubectl命令均可正常返回结果;运行期间监控到服务端资源占用正常:CPU利用率稳定在30%-40%,总内存3.74G,已使用583M,不存在资源过载情况
- 按标准流程接入第二台Agent节点后,在服务端节点执行kubectl命令出现固定超时错误,执行
kubectl get nodes的报错信息如下:
root@k3s-master:/home/marc# kubectl get nodes Error from server (Timeout): the server was unable to return a response in the time allotted, but may still be processing the request (get nodes)
基础配置与部署流程
硬件与系统参数
- 集群硬件为2台配置4GB内存的树莓派4B
- 节点系统为全新安装的Raspbian Lite(Buster版本),已按K3S官方要求开启Legacy iptables、cgroups相关系统配置
集群部署操作
- 服务端节点执行官方标准安装命令完成部署:
curl -sfL https://get.k3s.io | sh - - Agent节点配置服务端接入地址
K3S_URL与集群认证K3S_TOKEN后,执行接入命令完成节点注册:curl -sfL https://get.k3s.io | K3S_URL=https://k3s-master:6443 K3S_TOKEN=<token> sh -
可落地排查方案与解决方向
- 排查跨节点网络与端口放通状态
- 从Agent节点主动测试服务端6443 API端口的连通性,排除端口被拦截、IPtables规则异常导致的API Server连接阻塞
- 逐一验证集群内部必需通信端口的连通性:Flannel VXLAN通信的8472/udp端口、K3S内部控制器的8900/tcp端口、节点metrics采集的9100/tcp端口
- 注意:仅在raspi-config中开启Legacy iptables参数但未重启节点的情况下,系统依然会使用nftables后端的规则链,直接导致跨节点通信丢包,是树莓派Buster版本运行K3S的高频踩坑点
- 修正节点主机名解析配置
- 检查所有节点
/etc/hosts条目,确保两个节点可通过主机名双向解析到正确内网IP,排除反向解析失败导致的API Server查询节点列表时挂起等待 - 可通过带短超时的命令快速定位问题:执行
kubectl get nodes --request-timeout=5s,如果请求无响应或耗时极长后返回结果,基本可确认是DNS解析链路阻塞
- 检查所有节点
- 调整K3S服务端参数适配ARM平台特性
- 树莓派ARM架构下,K3S默认的kube-apiserver并发线程配置偏高会引发不必要的上下文切换开销,可在服务端K3S启动参数中增加配置:
--kube-apiserver-flag="--max-requests-inflight=200" --kube-apiserver-flag="--max-mutating-requests-inflight=100",修改完成后重启k3s服务验证
- 树莓派ARM架构下,K3S默认的kube-apiserver并发线程配置偏高会引发不必要的上下文切换开销,可在服务端K3S启动参数中增加配置:
- 临时关闭非必要组件排除资源争抢
- 单节点独立运行状态下资源消耗低、命令响应正常,接入Agent后可先临时停用Traefik Ingress、CoreDNS自动扩容功能,验证是否为组件资源争抢引发的API响应超时
内容的提问来源于stack exchange,提问作者plsfix
相关产品推荐
相关产品推荐

