Debian系统Kubernetes安装后的验证方法

Debian系统Kubernetes安装后的验证清单

一 基础可达性与组件版本

• 检查 kubectl 客户端：执行 kubectl version --client，确认已安装且能输出版本信息。
• 检查集群连通与版本：执行 kubectl version，应同时看到 Client Version 与 Server Version；如仅看到客户端，说明 kubeconfig 未正确指向集群。
• 查看集群概况：执行 kubectl cluster-info，确认 Kubernetes control plane 与 CoreDNS 等核心服务地址可达。
• 若 kubectl 报权限或找不到配置：确认 ~/.kube/config 存在且当前用户有读取权限（主节点初始化后通常会复制到该路径）。

二 节点与系统组件状态

• 节点状态：执行 kubectl get nodes，所有节点应为 Ready。如为 NotReady，优先检查容器运行时、网络插件与 kubelet。
• 系统组件 Pod：执行 kubectl get pods -n kube-system，常见组件如 kube-apiserver、kube-controller-manager、kube-scheduler、etcd、coredns 以及你部署的网络插件（如 flannel）应处于 Running。
• 节点污点与网络：确认控制平面节点未因污点阻止调度（默认情况下控制平面可调度，若你手动设置了污点需相应容忍）；网络插件就绪后跨节点 Pod 通信应正常。
• 容器运行时与 kubelet：在 Debian 上常见运行时为 containerd（或 Docker 的 containerd 引擎）。可执行 sudo systemctl status containerd 与 sudo systemctl status kubelet 查看是否 active (running)；kubelet 日志可用 journalctl -u kubelet -f 持续跟踪。

三 网络与服务端到端验证

• 部署测试应用：执行 kubectl create deployment nginx --image=nginx --replicas=2。
• 暴露服务：执行 kubectl expose deployment nginx --type=NodePort --port=80，随后 kubectl get svc nginx 查看分配的 NodePort。
• 访问验证：从集群外部访问 http://< 任意节点IP> :，应返回 Nginx 欢迎页；在集群内部可用 curl http://:80 验证。
• 清理：验证完成后可执行 kubectl delete deployment nginx 与 kubectl delete svc nginx 清理资源。

四 常见问题快速排查

• 节点 NotReady：
  • 确认已关闭 Swap（执行 sudo swapoff -a 并注释 /etc/fstab 中的 swap 行）。
  • 确认内核参数已加载：overlay 与 br_netfilter，以及 net.bridge.bridge-nf-call-iptables=1、net.ipv4.ip_forward=1（执行 sudo sysctl --system 使配置生效）。
  • 确认网络插件已部署且 Pod 为 Running（如 kubectl get pods -n kube-system -l app=flannel）。
• kubectl 无法连接：确认 ~/.kube/config 正确，或重新拷贝 /etc/kubernetes/admin.conf 到 $HOME/.kube/config 并修正权限。
• 端口与防火墙：确保 6443（API Server）、10250（kubelet）等端口在节点间放通；云环境需在安全组放行对应端口。
• 查看日志定位：使用 journalctl -u kubelet 与 kubectl describe pod -n kube-system 获取详细错误信息。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！