温馨提示×

Debian装K8s步骤是什么

小樊
43
2026-08-01 11:49:49
栏目: 智能运维

下面给你一份在 Debian(11/12 常见版本)上安装 Kubernetes(kubeadm 方式)标准流程,适合生产/学习环境。


一、环境准备

1️⃣ 系统要求

  • Debian 11 (Bullseye) / 12 (Bookworm)
  • 2 核 CPU 以上
  • 内存 ≥ 2GB(Master 建议 4GB)
  • 多台机器(1 Master + N Node)

2️⃣ 关闭 swap(必须)

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

3️⃣ 设置主机名(每台机器)

sudo hostnamectl set-hostname master
# 或 node1、node2

4️⃣ 配置 hosts(可选但推荐)

cat <<EOF | sudo tee /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

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

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]
  [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
    SystemdCgroup = true

5️⃣ 重启 containerd

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 Kubernetes(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

可替换 v1.29 为你需要的版本

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(Master)

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

测试:

kubectl get nodes

六、安装网络插件(CNI)

推荐:Calico

kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml

或 Flannel:

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

七、加入 Node 节点

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

九、常见补充

✅ 允许 master 运行 Pod(单节点)

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

✅ 查看日志

journalctl -u kubelet -f

十、总结流程

系统准备
 → 安装 containerd
 → 安装 kubeadm/kubelet/kubectl
 → kubeadm init
 → 安装 CNI
 → 加入 node
 → 验证集群

如果你需要:

  • Debian + 单节点
  • Debian + 离线安装
  • Debian + 指定 K8s 版本
  • Debian + 国内镜像加速

可以直接告诉我,我可以给你定制版本 ✅

0