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 获取详细错误信息。