温馨提示×

debian升级后k8s咋部署

小樊
45
2026-10-22 20:11:59
栏目: 智能运维

在 Debian 升级系统(比如 Debian 11 → 12,或内核/小版本升级)之后部署或恢复 Kubernetes,一般分 “已有集群恢复” 和 “重新部署新集群” 两种情况。下面按常见场景给你一套清晰流程。


一、升级 Debian 后先确认环境

cat /etc/os-release
uname -a

1. 检查已安装的 k8s 组件

kubeadm version
kubelet --version
kubectl version

如果命令不存在,说明升级时可能被清理了。

2. 检查容器运行时

K8s 现在一般使用 containerd(不再推荐 docker)

systemctl status containerd
ctr version

如果没了:

apt install -y containerd

二、已有集群(升级 Debian 后恢复)

1. 重新安装匹配版本的 kubelet / kubeadm

查看之前版本:

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

2. 启动 kubelet

systemctl enable --now kubelet

3. 检查节点状态

kubectl get nodes

如果 NotReady:

journalctl -u kubelet -f

三、全新部署 Kubernetes(Debian 12 推荐)

1. 基础设置

# 关闭 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

2. 安装 containerd

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

3. 安装 k8s 组件

见上面 apt 源配置,然后:

apt install -y kubelet kubeadm kubectl
systemctl enable kubelet

4. 初始化 Master(单节点示例)

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

5. 安装网络插件(Flannel 示例)

kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml

四、常见问题(Debian 升级后)

1. cgroup 驱动不一致

确保:

  • containerd:SystemdCgroup = true
  • kubelet:--cgroup-driver=systemd

2. iptables 被 nftables 影响

Debian 12 默认 nftables:

update-alternatives --set iptables /usr/sbin/iptables-legacy

3. kubelet 起不来

journalctl -u kubelet -n 100

常见原因:

  • swap 没关
  • containerd 没启动
  • 证书过期

五、建议版本组合(2024+)

组件 推荐
Debian 12 (bookworm)
Kubernetes 1.29 / 1.30
Runtime containerd 1.7+

如果你告诉我:

  • Debian 升级前/后版本
  • 是 单节点还是集群
  • k8s 之前是否正常运行

我可以直接给你 针对性修复命令。

0 踩