Kubernetes部署在Debian上的常見問題

在Debian上部署Kubernetes（K8s）集群時，可能會遇到一些常見問題。以下是一些常見問題及其解決方法：

服務訪問失敗

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

Pod狀態為ErrImagePull

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

節點無法注冊到Master節點

• 問題描述：從節點在執行kubeadm join命令時失敗，提示無法獲取配置Map或Token失效。
• 原因分析：可能是Token失效或配置文件錯誤。
• 解決方法：在Master節點上重新生成Token和配置文件，然后重新加入節點。確保/etc/kubernetes/admin.conf文件權限正確，并且kubectl配置正確。

網絡插件問題

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

內核參數問題

• 問題描述：在調整內核參數時出現錯誤，如sysctl: cannot stat /proc/sys/net/bridge/bridge-nf-call-iptables。
• 原因分析：可能是內核模塊缺失或配置錯誤。
• 解決方法：加載必要的內核模塊，如br_netfilter。確保/proc/sys/net/ipv4/ip_forward設置為1。

Docker版本不匹配

• 問題描述：在初始化Master節點或加入節點時，提示Docker版本不在驗證列表中。
• 原因分析：Docker版本與Kubernetes版本不兼容。
• 解決方法：安裝與Kubernetes版本兼容的Docker版本。如果必須使用新版本Docker，可能需要降級Kubernetes組件到兼容的版本。

資源不足

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

時區不一致問題

• 問題描述：容器中的時區與宿主機不一致，導致時間不同步。
• 解決方法：在部署工作負載時為容器指定TZ環境變量，例如：

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: app
  spec:
    replicas: 1
    selector:
      matchLabels:
        app: app
    template:
      metadata:
        labels:
          app: app
      spec:
        containers:
        - name: app
          image: app
          env:
          - name: TZ
            value: Asia/Shanghai
  

  或者在Dockerfile里設置時區：

  FROM ubuntu:latest
  RUN apt update -y && \
      DEBIAN_FRONTEND="noninteractive" apt -y install tzdata && \
      ln -fs /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
      dpkg-reconfigure -f noninteractive tzdata
  

文件系統問題

• 問題描述：文件系統錯誤或損壞。
• 解決方法：使用和修復文件系統，例如使用fsck命令檢查和修復文件系統，特別是在非正常關機后。

Kubernetes集群初始化失敗

• 問題描述：Kubernetes集群初始化失敗，提示環境配置錯誤。
• 解決方法：確保關閉swap、防火墻，并正確配置sysctl參數和內核參數。添加鏡像源，確保Kubernetes組件的鏡像源配置正確，并更新源。

通過了解和解決這些常見問題，可以確保在Debian系統上成功部署和運行Kubernetes集群。