Debian系统与Kubernetes的集成实践

一环境准备与系统基线

节点基线：建议每个节点至少具备2 核 CPU、2 GB 内存、20 GB 磁盘，并确保节点间网络互通；操作系统建议使用Debian 12或更高版本。
主机名与解析：为各节点设置唯一主机名，并在所有节点的**/etc/hosts**中完成解析，便于集群内通信与排障。
关闭 Swap：Kubelet 要求关闭 Swap，执行：sudo swapoff -a，并在**/etc/fstab**中注释或移除 swap 条目，避免重启后恢复。
容器运行时：生产环境优先使用containerd；若使用 Docker，需确保其与 Kubernetes 版本兼容并正确配置 cgroup 驱动。
防火墙与端口：放行控制面与工作节点通信所需端口，例如6443（API Server）、10250（kubelet）等，避免节点 NotReady 或组件异常。

二安装容器运行时与Kubernetes组件

安装 containerd（推荐）：
- 安装与启用：sudo apt install -y containerd
- 生成默认配置：sudo mkdir -p /etc/containerd && containerd config default | sudo tee /etc/containerd/config.toml
- 按需调整 cgroup 驱动（与 kubelet 保持一致，常见为 systemd），然后：sudo systemctl daemon-reload && sudo systemctl enable --now containerd
安装 Docker（可选）：
- 添加仓库并安装：sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io
- 启动与开机自启：sudo systemctl start docker && sudo systemctl enable docker

添加 Kubernetes APT 仓库并安装组件：

导入 GPG 与仓库（示例为 Debian 12 “bookworm”）：

sudo apt update
sudo apt install -y apt-transport-https ca-certificates 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

说明：Kubernetes 官方 APT 仓库当前仍使用发行代号xenial，在Debian 12上可用；安装后将 kubelet 设为开机自启：sudo systemctl enable --now kubelet。

三初始化控制平面与网络插件

初始化控制平面（单主示例）：
```
sudo kubeadm init \
  --apiserver-advertise-address <MASTER_IP> \
  --control-plane-endpoint <MASTER_IP>:6443 \
  --pod-network-cidr 10.244.0.0/16 \
  --service-cidr 10.100.0.0/16 \
  --image-repository registry.aliyuncs.com/google_containers
```
- 常见参数说明：
  - –pod-network-cidr：与所选 CNI 插件规划保持一致（如 Flannel 常用10.244.0.0/16）。
  - –service-cidr：集群 Service 网段，避免与宿主机/内网网段冲突。
  - –image-repository：在受限网络环境下可指定国内镜像仓库以加速拉取。

配置 kubectl：

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

安装 CNI 网络插件（二选一）：
- Flannel：kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
- Calico：kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml
验证：kubectl cluster-info、kubectl get nodes 应显示控制平面节点状态为Ready。

四加入工作节点与日常运维

加入工作节点：在 Master 初始化完成后，使用输出的 kubeadm join ... 命令在各 Worker 上执行，例如：
```
sudo kubeadm join <MASTER_IP>:6443 \
  --token <TOKEN> \
  --discovery-token-ca-cert-hash sha256:<HASH>
```
加入成功后，回到 Master 执行 kubectl get nodes 查看节点状态。
节点管理与资源：
- 使用节点标签进行调度：kubectl label node <node> disktype=ssd
- 为工作负载设置资源请求/限制，提升稳定性与密度。
- 如需 GPU：安装对应驱动与设备插件，并在 Pod 中请求 nvidia.com/gpu。
监控与可视化：
- 部署 Prometheus + Grafana（可用 Operator/Helm），监控集群与应用指标。
- 使用 Kubernetes Dashboard 或终端工具 K9s 进行日常巡检与快速排障。

五常见问题与优化建议

节点 NotReady：优先检查Swap 是否彻底关闭、CNI 是否已安装并 Running、容器运行时是否就绪、以及防火墙/安全组端口是否放行。
镜像拉取失败：在受限网络中使用 --image-repository registry.aliyuncs.com/google_containers 或配置私有镜像仓库/镜像代理。
版本与兼容性：保持 kubelet/kubeadm/kubectl 版本一致；选择与 Kubernetes 版本匹配的 containerd/Docker 版本。
生产建议：
- 采用多控制平面与高可用拓扑（如 kubeadm HA）。
- 启用 RBAC、网络策略、Pod 安全准入与审计日志。
- 使用 Helm 管理常用应用与组件，结合 GitOps 流程进行交付与回滚。
- 定期升级集群与节点组件，遵循官方支持周期。

最新问答

相关标签