在 Debian 升级系统(比如 Debian 11 → 12,或内核/小版本升级)之后部署或恢复 Kubernetes,一般分 “已有集群恢复” 和 “重新部署新集群” 两种情况。下面按常见场景给你一套清晰流程。
cat /etc/os-release
uname -a
kubeadm version
kubelet --version
kubectl version
如果命令不存在,说明升级时可能被清理了。
K8s 现在一般使用 containerd(不再推荐 docker)
systemctl status containerd
ctr version
如果没了:
apt install -y containerd
查看之前版本:
kubeadm version
添加 K8s apt 源(示例 1.29):
apt-get update
apt-get install -y apt-transport-https ca-certificates curl
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.29/deb/Release.key | gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.29/deb/ /' > /etc/apt/sources.list.d/kubernetes.list
apt update
apt install -y kubelet kubeadm kubectl
systemctl enable --now kubelet
kubectl get nodes
如果 NotReady:
journalctl -u kubelet -f
# 关闭 swap
swapoff -a
sed -i '/swap/d' /etc/fstab
# 内核参数
cat <<EOF | tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF
modprobe overlay
modprobe br_netfilter
cat <<EOF | tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-iptables = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward = 1
EOF
sysctl --system
apt install -y containerd
mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml
# 使用 systemd cgroup
sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
systemctl restart containerd
systemctl enable containerd
见上面 apt 源配置,然后:
apt install -y kubelet kubeadm kubectl
systemctl enable kubelet
kubeadm init \
--pod-network-cidr=10.244.0.0/16
初始化完成后:
mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config
kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml
确保:
SystemdCgroup = true--cgroup-driver=systemdDebian 12 默认 nftables:
update-alternatives --set iptables /usr/sbin/iptables-legacy
journalctl -u kubelet -n 100
常见原因:
| 组件 | 推荐 |
|---|---|
| Debian | 12 (bookworm) |
| Kubernetes | 1.29 / 1.30 |
| Runtime | containerd 1.7+ |
如果你告诉我:
我可以直接给你 针对性修复命令。