Debian上Kubernetes部署的故障排查方法

在Debian上部署Kubernetes（K8S）集群時，可能會遇到各種問題。以下是一些常見問題及其解決方法，以及一些故障排查的步驟和命令：

常見問題及解決方法

1. 服務訪問失敗

   • 原因分析：可能是由于證書問題、端口映射錯誤、服務類型設置不正確等原因。
   • 解決方法：檢查證書是否正確配置，必要時更新證書。檢查端口映射是否正確，刪除并重新創建服務（kubectl delete svc service-name）。如果服務類型為ClusterIP，確保外網可以訪問，或者修改為NodePort類型。

2. Pod狀態為ErrImagePull

   • 原因分析：可能是鏡像不存在或鏡像標簽錯誤。
   • 解決方法：檢查鏡像名稱和標簽是否正確。確保鏡像存在于指定的倉庫中，并且可以訪問。如果使用私有倉庫，確保/etc/docker/certs.d/目錄下有正確的證書文件。

3. 節點無法注冊到Master節點

   • 原因分析：可能是Token失效或配置文件錯誤。
   • 解決方法：在Master節點上重新生成Token和配置文件，然后重新加入節點。確保/etc/kubernetes/admin.conf文件權限正確，并且kubectl配置正確。

4. 網絡插件問題

   • 原因分析：可能是網絡插件配置文件錯誤或網絡參數設置不正確。
   • 解決方法：刪除現有網絡插件的配置文件和殘留文件，然后重新部署。確保網絡參數（如IP轉發）已正確設置。

5. 內核參數問題

   • 原因分析：可能是內核模塊缺失或配置錯誤。
   • 解決方法：加載必要的內核模塊，如br_netfilter。確保/proc/sys/net/ipv4/ip_forward設置為1。

6. Docker版本不匹配

   • 原因分析：Docker版本與Kubernetes版本不兼容。
   • 解決方法：安裝與Kubernetes版本兼容的Docker版本。如果必須使用新版本Docker，可能需要降級Kubernetes組件到兼容的版本。

7. 資源不足

   • 原因分析：節點磁盤空間不足，導致Pod被驅逐（Evicted）。
   • 解決方法：清理磁盤空間，刪除不必要的文件。增加節點磁盤空間或擴展存儲。

8. kubectl debug使用問題

   • 解決方法：在生產環境中，需要對正在運行的Pod進行調試。使用kubectl debug命令進入Pod的調試模式，添加調試工具進行故障排查。

故障排查步驟和命令

1. 集群信息查詢

   • 獲取Kubernetes版本信息：kubectl version
   • 顯示集群信息：kubectl cluster-info
   • 列出集群中的所有節點：kubectl get nodes
   • 列出所有命名空間：kubectl get namespaces
   • 列出所有命名空間中的所有Pods：kubectl get pods -a
   • 查看某個節點的詳細信息：kubectl describe node 節點名

2. Pod診斷技巧

   • 列出特定命名空間中的Pods：kubectl get pods -n 命令空間
   • 查看某個Pod的詳細信息：kubectl describe pod pod-name -n 命令空間
   • 查看Pod日志：kubectl logs pod-name -n 命令空間
   • 查看Pod的實時日志：kubectl logs -f pod-name -n 命令空間
   • 在Pod中執行特定命令：kubectl exec -it pod-name -n 命令空間 -- command
   • 檢查Pod的準備情況：kubectl get pods pod-name -n 命令空間 -o jsonpath '{.status.conditions[?(@.type"ready")].status}'
   • 檢查Pod事件：kubectl get events -n 命令空間 --field-selector involvedobject.name=pod-name

3. 服務狀態檢查

   • 列出命名空間中的所有服務：kubectl get svc -n 命令空間
   • 查看某個服務的詳細信息：kubectl describe svc service-name -n 命令空間

4. 節點故障排查

   • 分析節點問題，如節點狀態、資源分配等：kubectl describe node 節點名

5. 常見問題及解決方法

   • kubectl命令無法連接到服務器：檢查kubeconfig文件配置是否正確。確認apiserver服務是否正常運行。檢查防火墻設置，確保相關端口（如6443）是開放的。
   • Pod日志獲取失?。捍_認Pod名稱和命名空間是否正確。檢查是否有足夠的權限查看Pod日志。

通過以上步驟和命令，您可以有效地診斷和解決在Debian上部署Kubernetes時遇到的問題。如果問題依然存在，建議查閱Kubernetes官方文檔或社區論壇尋求幫助。