在Debian上部署Kubernetes（K8S）集群可能會遇到一些常見問題，但通過遵循詳細的步驟和配置，可以解決這些難題。以下是一個基于Debian 12的Kubernetes部署指南，幫助你解決常見的部署問題。
在每個節點上設置主機名，并在/etc/hosts文件中添加節點IP和主機名的映射。
sudo hostnamectl set-hostname "k8s-master01"
echo "192.168.16.20 k8s-master01.test.local k8s-master01" >> /etc/hosts
關閉所有節點的交換分區，以確保kubelet順利運行。
sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab
允許必要的端口，例如Kubernetes API服務器的端口6443。
sudo ufw allow 6443/tcp
sudo ufw reload
在所有節點上安裝containerd運行時，并配置必要的內核參數。
sudo apt update
sudo apt install -y containerd
sudo modprobe overlay
sudo modprobe br_netfilter
sudo tee /etc/modules-load.d/containerd.conf <<EOF
overlay br_netfilter
EOF
sudo tee /etc/sysctl.d/99-kubernetes-k8s.conf <<EOF
net.bridge.bridge-nf-call-iptables = 1
net.ipv4.ip_forward = 1
EOF
sudo sysctl --system
添加Kubernetes官方的apt倉庫，以便安裝Kubernetes軟件包。
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt update
安裝kubelet、kubeadm和kubectl。
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
在主節點上使用kubeadm init命令初始化集群，并記錄下加入命令。
sudo kubeadm init --apiserver-advertise-address=192.168.16.20
在每個工作節點上使用kubeadm join命令加入集群。
sudo kubeadm join 192.168.16.20:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>
安裝并配置網絡插件，例如Calico。
wget https://raw.githubusercontent.com/projectcalico/calico/master/manifests/calico.yaml
kubectl apply -f calico.yaml
使用kubectl命令驗證集群狀態。
kubectl get nodes
kubectl cluster-info
如果遇到鏡像拉取問題，可以嘗試更換國內鏡像源或者檢查網絡連接。
確保防火墻允許必要的端口，例如Kubernetes API服務器的端口6443。
關閉交換分區可以避免一些潛在的問題，確保kubelet順利運行。
通過以上步驟，你應該能夠在Debian上成功部署Kubernetes集群。如果在部署過程中遇到其他問題，可以參考Kubernetes官方文檔或相關社區資源進行排查和解決。
