温馨提示×

怎样在debian装k8s环境

小樊
50
2026-09-26 12:00:30
栏目: 智能运维

下面给你一个在 Debian 上搭建 Kubernetes(k8s)环境的常用、稳妥方案,适合学习、测试或生产前准备。以 Debian 11/12 + containerd + kubeadm 为例。


一、环境准备

1. 机器要求

  • 至少 2 台机器(1 master + 1 node,或单节点 all-in-one)
  • Debian 11/12
  • 2 CPU / 2GB 以上(生产建议更高)
  • 网络互通(关闭防火墙或放行端口)

2. 关闭 swap

sudo swapoff -a
sudo sed -i '/swap/s/^/#/' /etc/fstab

3. 设置主机名

sudo hostnamectl set-hostname master
# node 上
sudo hostnamectl set-hostname node1

4. 配置 hosts(所有节点)

cat <<EOF | sudo tee -a /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 apt-transport-https ca-certificates

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

编辑 /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

三、安装 kubeadm / kubelet / kubectl

1. 添加 Kubernetes 源

sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo 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 节点

sudo kubeadm init \
  --pod-network-cidr=10.244.0.0/16 \
  --cri-socket unix:///run/containerd/containerd.sock

初始化成功后:

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

五、安装网络插件(Flannel 示例)

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

六、加入 Node 节点

在 master 上获取命令:

kubeadm token create --print-join-command

在 node 上执行(示例):

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

七、验证

kubectl get nodes
kubectl get pods -A

八、常见问题

  • 节点 NotReady:网络插件未装或 containerd cgroup 配置错误
  • kubeadm 版本不一致:所有节点版本必须一致
  • 单节点可用:
kubectl taint nodes --all node-role.kubernetes.io/control-plane-

如果你愿意,我可以:

  • 给你 一键脚本
  • 教你 用 Kind / Minikube 本地玩 k8s
  • 或按 生产环境(HA、calico、helm) 配置

你现在是想 学习测试 还是 上生产?

0 踩