温馨提示×

Debian部署K8s要几步

小樊
34
2026-07-17 23:44:26
栏目: 智能运维

在 Debian 上部署 Kubernetes(K8s)通常分 7 个阶段、约 20 多个具体步骤。下面给你一个标准生产级部署流程(使用 kubeadm),适合 Debian 11/12。


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

1. 系统要求

  • Debian 11 (Bullseye) 或 12 (Bookworm)
  • 2 核 CPU / 4G 内存以上(Master 建议更高)
  • 禁用 swap
  • 唯一 hostname / MAC / product_uuid

2. 设置主机名

hostnamectl set-hostname master

3. 配置 hosts(可选)

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

4. 关闭 swap

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

5. 加载内核模块

cat <<EOF | tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF

modprobe overlay
modprobe br_netfilter

6. 内核参数

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

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

7. 安装依赖

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

8. 安装 containerd

apt install -y containerd

9. 生成默认配置

mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml

10. 启用 Systemd Cgroup

sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
systemctl restart containerd
systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

11. 添加 Kubernetes 源

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

12. 安装组件

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

四、初始化 Master 节点

13. 初始化集群

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

14. 配置 kubectl

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

五、安装网络插件(CNI)

15. 安装 Flannel(常用)

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

六、添加 Worker 节点

16. 在 Master 获取 join 命令

kubeadm token create --print-join-command

17. 在 Node 执行

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

七、验证集群

18. 查看节点

kubectl get nodes

19. 查看组件状态

kubectl get pods -n kube-system

八、总结(最简版)

阶段 关键步骤
系统准备 关 swap / 内核参数
容器运行时 containerd
K8s 组件 kubeadm / kubelet / kubectl
初始化 kubeadm init
网络 CNI(Flannel / Calico)
扩容 kubeadm join

九、要不要更快?

如果你只是测试 / 本地学习,我可以给你:

  • 一条命令脚本版
  • 基于 Debian + k3s(超轻量)
  • 使用 Ansible 自动化部署

你是 生产环境 还是 学习 / 测试

0