Debian与Kubernetes部署指南

Debian 12 上部署 Kubernetes 的标准流程

一环境准备

节点规划：至少准备 1 台控制平面（Master） 与 1 台工作节点（Worker）；建议 2 核 CPU、2GB RAM、20GB 磁盘 以上，节点间可互通，最好使用 静态 IP。
系统设置：
- 关闭 Swap：sudo swapoff -a，并在 /etc/fstab 中注释 Swap 行。
- 内核与转发：加载模块 overlay、br_netfilter，开启桥接与转发。
- 时间同步：安装并启用 NTP/chrony，避免证书与调度异常。
- 主机名与解析：为各节点设置唯一 hostname，必要时在 /etc/hosts 配置解析。
- 防火墙：放通 6443（API Server）、10250（kubelet）、8472（Flannel VXLAN）、30000–32767（NodePort） 等端口，或临时关闭防火墙用于测试。

二安装容器运行时 containerd

安装与启用：

sudo apt update && sudo apt install -y containerd
sudo systemctl enable --now containerd

配置 SystemdCgroup（与 kubelet 一致）：

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml
sudo sed -i 's/SystemdCgroup \= false/SystemdCgroup \= true/g' /etc/containerd/config.toml
sudo systemctl restart containerd

说明：本指南采用 containerd 作为运行时（更符合当前主流实践）；如需使用 Docker，可改为安装 docker-ce 并配置其 cri-dockerd 适配器。

三安装 kubeadm kubelet kubectl

添加 Kubernetes APT 源并安装组件：

sudo apt update && sudo apt install -y apt-transport-https curl gnupg
curl -fsSL https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/kubernetes-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] 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
sudo systemctl enable --now kubelet

提示：保持 kubelet 为最新稳定版，避免与控制平面版本偏差过大。

四初始化控制平面与网络

初始化（示例网段可按需调整）：

sudo kubeadm init \
  --pod-network-cidr=10.244.0.0/16 \
  --service-cidr=10.96.0.0/12 \
  --apiserver-advertise-address=<MASTER_IP>

配置 kubectl：

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

安装网络插件（Flannel，与上面 Pod CIDR 匹配）：

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

可选镜像加速（国内环境）：

sudo kubeadm init \
  --image-repository registry.aliyuncs.com/google_containers \
  --pod-network-cidr=10.244.0.0/16 \
  --apiserver-advertise-address=<MASTER_IP>

验证：

kubectl cluster-info
kubectl get nodes
kubectl get pods -n kube-system

五加入工作节点与验证

在 Worker 节点执行 kubeadm init 完成后输出的 kubeadm join 命令，例如：

sudo kubeadm join <MASTER_IP>:6443 \
  --token <TOKEN> \
  --discovery-token-ca-cert-hash sha256:<HASH>

在 Master 上验证：

kubectl get nodes
kubectl get pods -n kube-system

部署测试应用（验证网络与服务发布）：

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
# 访问 http://<任一节点IP>:<NodePort>

六常见问题与优化

节点 NotReady：多因 CNI 未就绪 或 kubelet 未启动；检查 kubectl get pods -n kube-system、确认 Flannel/其他 CNI 已 Running，查看 journalctl -u kubelet。
Swap 未关闭：Kubelet 要求关闭 Swap，执行 sudo swapoff -a 并注释 /etc/fstab 中的 Swap 行。
镜像拉取慢/失败：使用国内镜像仓库或在 kubeadm init 中指定 --image-repository。
端口未放通：确保 6443/10250/8472/30000–32767 等端口在防火墙放行。
时间不同步：部署 NTP/chrony 并校准时间。
自动化部署：可使用 Ansible 编排上述步骤，或使用 KubeKey 一键部署（适合快速交付与测试）。

最新问答

相关标签