温馨提示×

Debian部署K8s步骤对不对

小樊
41
2026-07-18 02:51:36
栏目: 智能运维

下面给你一份在 Debian 上部署 Kubernetes(k8s)的通用正确步骤,你可以对照看看你现在的步骤是否一致。
(以 Debian 11/12 + kubeadm 为例,这是目前最主流、官方推荐的方式)


一、环境准备(所有节点都要做)

1️⃣ 系统要求

  • Debian 11 (Bullseye) 或 12 (Bookworm)
  • 2 CPU 及以上
  • 2GB+ 内存
  • 禁用 swap
  • 各节点网络互通

2️⃣ 关闭 swap

sudo swapoff -a
sudo sed -i '/swap/d' /etc/fstab

3️⃣ 设置主机名(可选但推荐)

hostnamectl set-hostname master
# 或者 node1、node2

4️⃣ 配置 hosts(可选)

cat <<EOF >> /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

二、安装容器运行时(containerd)

⚠️ Kubernetes 已不再支持 Docker

1️⃣ 安装依赖

sudo apt update
sudo apt install -y curl gnupg2 software-properties-common

2️⃣ 安装 containerd

sudo apt install -y containerd

3️⃣ 生成默认配置

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

4️⃣ 启用 systemd cgroup

编辑:

sudo nano /etc/containerd/config.toml

修改:

[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
  SystemdCgroup = true

5️⃣ 重启

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

1️⃣ 添加 Kubernetes 官方源

curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.29/deb/Release.key | sudo 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/ /" | sudo tee /etc/apt/sources.list.d/kubernetes.list

2️⃣ 安装

sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

四、初始化 Master 节点

⚠️ 只在 master 执行

sudo kubeadm init \
  --pod-network-cidr=10.244.0.0/16

初始化成功后,会输出类似:

kubeadm join 192.168.1.10:6443 --token xxx --discovery-token-ca-cert-hash sha256:xxx

配置 kubectl

mkdir -p $HOME/.kube
sudo cp /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

五、安装网络插件(CNI)

推荐 Flannel(最简单)

kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml

检查:

kubectl get pods -n kube-system

六、Worker 节点加入集群

node 节点执行 master 输出的 join 命令

sudo kubeadm join 192.168.1.10:6443 \
  --token xxx \
  --discovery-token-ca-cert-hash sha256:xxx

七、验证集群

kubectl get nodes
kubectl get pods -A

✅ 常见错误检查

问题 原因
swap 未关闭 kubelet 起不来
containerd 未配置 SystemdCgroup 节点 NotReady
没装 CNI 节点一直 NotReady
Debian 防火墙 端口未放行

❓你可以这样确认你的步骤对不对

你可以直接把你的 部署步骤或报错贴出来,我可以逐条帮你对照,比如:

  • 是否用了 kubeadm
  • 是否用了 containerd
  • swap 是否关了
  • 网络插件是否匹配

如果你愿意,也可以告诉我:

  • Debian 版本
  • 单节点还是多节点
  • 是否离线部署 / 国内环境

我可以给你完全针对你环境的部署方案

0