Debian上K8S部署常見問題及解決

以下是Debian上部署Kubernetes（K8S）的常見問題及解決方法：

1. 證書問題

   • 現象：訪問K8S服務時證書驗證失敗。
   • 原因：證書過期或未包含在默認信任庫中。
   • 解決：更新證書或通過--cacert指定自定義證書文件。

2. 端口映射錯誤

   • 現象：服務無法通過端口訪問。
   • 原因：端口映射配置錯誤或服務類型為ClusterIP。
   • 解決：刪除并重新創建服務，正確配置端口映射；如需外部訪問，將服務類型改為NodePort或LoadBalancer。

3. 鏡像拉取失敗

   • 現象：Pod狀態顯示ErrImagePull。
   • 原因：鏡像名稱錯誤、標簽不匹配或倉庫不可訪問。
   • 解決：檢查鏡像名稱和標簽，確保鏡像存在于倉庫；配置私有倉庫證書或使用ImagePullPolicy: Always。

4. 節點無法注冊到Master

   • 現象：工作節點執行kubeadm join失敗。
   • 原因：Token失效或配置文件錯誤。
   • 解決：在Master節點重新生成Token和配置文件，確保/etc/kubernetes/admin.conf權限正確。

5. 網絡插件問題

   • 現象：Pod間無法通信或服務發現失敗。
   • 原因：網絡插件（如Flannel/Calico）配置錯誤或未正確安裝。
   • 解決：刪除殘留配置并重新部署網絡插件，檢查防火墻是否允許插件所需端口。

6. 資源不足

   • 現象：Pod被驅逐或無法調度。
   • 原因：節點磁盤空間、CPU或內存不足。
   • 解決：清理節點資源，調整Pod的資源請求和限制，或擴展節點。

7. 內核參數問題

   • 現象：出現sysctl相關錯誤（如bridge-nf-call-iptables）。
   • 解決：加載br_netfilter模塊，設置/proc/sys/net/ipv4/ip_forward=1。

8. 版本兼容性問題

   • 現象：組件版本不兼容導致初始化失敗。
   • 解決：參考K8S官方文檔，確保Kubernetes與Docker、網絡插件等組件版本兼容。

9. 權限問題

   • 現象：命令執行失敗，提示Permission denied。
   • 解決：使用sudo運行命令，檢查RBAC配置是否正確。

10. 日志與調試

    • 現象：無法定位錯誤根源。
    • 解決：通過kubectl logs查看Pod日志，使用journalctl -u kubelet查看節點服務日志。

操作前建議：關閉交換分區（swapoff -a），確保防火墻開放K8S必要端口（如6443、10250等）。如問題仍未解決，可參考K8S官方文檔或社區論壇獲取進一步支持。