Debian K8S集群如何搭建

Debian K8s集群搭建详细步骤

一、前置准备

1. 系统要求

• 硬件：所有节点（Master/Worker）需满足至少2核CPU、2GB RAM、20GB可用磁盘空间；
• 软件：推荐使用Debian 10及以上稳定版本；
• 网络：所有节点之间需能互相通信（无防火墙阻拦或开放必要端口，如6443（API Server）、10250（kubelet）等）。

2. 主机配置

• 设置主机名：在Master节点运行sudo hostnamectl set-hostname k8s-master，Worker节点依次设置为k8s-node1、k8s-node2（按需调整）；
• 配置hosts文件：在所有节点编辑/etc/hosts，添加节点IP与主机名映射（示例）：

  echo "192.168.1.10 k8s-master" | sudo tee -a /etc/hosts
  echo "192.168.1.11 k8s-node1" | sudo tee -a /etc/hosts
  echo "192.168.1.12 k8s-node2" | sudo tee -a /etc/hosts
  

• 关闭Swap分区：Kubelet要求禁用Swap，执行以下命令：

  sudo swapoff -a
  sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab
  

3. 安装必要工具

• 安装Containerd（K8s推荐的容器运行时）：

  sudo apt update
  sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
  curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
  echo "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
  sudo apt update
  sudo apt install -y containerd
  sudo mkdir -p /etc/containerd
  sudo tee /etc/containerd/config.toml <<EOF
  [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
    SystemdCgroup = true
  EOF
  sudo systemctl restart containerd
  sudo systemctl enable containerd
  

• 添加Kubernetes源并安装组件：

  curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
  echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
  sudo apt update
  sudo apt install -y kubelet kubeadm kubectl
  sudo apt-mark hold kubelet kubeadm kubectl  # 锁定版本避免自动升级
  

二、初始化Master节点

在Master节点执行以下命令初始化集群（以Calico网络插件为例，需指定Pod CIDR）：

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

初始化完成后，配置kubectl以连接集群：

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

三、安装网络插件

K8s需要网络插件实现Pod间通信，常用Calico（适合生产环境）：

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

验证插件是否运行正常：

kubectl get pods -n kube-system
# 应显示所有Pod处于Running状态

四、加入Worker节点

在Master节点初始化完成后，会输出kubeadm join命令（包含Token和CA证书哈希）。在每台Worker节点执行该命令即可加入集群：

sudo kubeadm join 192.168.1.10:6443 --token abcdef.0123456789abcdef --discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

五、验证集群状态

回到Master节点，执行以下命令检查集群健康状态：

kubectl cluster-info  # 查看集群信息
kubectl get nodes     # 查看节点状态（应为Ready）
kubectl get pods --all-namespaces  # 查看所有命名空间的Pod状态

六、部署测试应用（可选）

部署一个Nginx示例应用，验证集群功能：

kubectl create deployment nginx-app --image=nginx --replicas=2
kubectl expose deployment nginx-app --name=nginx-web-svc --type=NodePort --port=80 --target-port=80
kubectl get svc nginx-web-svc  # 查看Service的NodePort（如30080）

通过任意节点IP加NodePort访问Nginx（如http://<节点IP>:30080），应能看到Nginx欢迎页面。

注意事项

• 所有节点时间需同步（建议安装ntp服务）；
• 若使用防火墙，需开放K8s必要端口（如6443、10250、10255等）；
• 生产环境中建议使用更安全的网络插件（如Calico的企业版）及认证机制（如RBAC）；
• 定期备份/etc/kubernetes目录（包含集群配置）。