在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官方文档或相关社区资源进行排查和解决。
亿速云「云服务器」，即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘，价格低至29元/月。点击查看>>
推荐阅读：如何解决Debian上K8s部署冲突
